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PREFACE 


This publication contains quick reference information for the experienced 
programmer. For the most part, definitions, restrictions, and limitations have 

been omitted to provide the most rapid access to the information in this 

publication. If the reference to information included here is not sufficient, 

refer to the publication list on the first page of each section; then refer to the 
applicable Systems Reference Library publication. * 


This publication, the OS/VS2 TSO Command Language Reference Summary, 
GX28-0647, the OS/VS Service Aids Reference Summary, GX28-0634, may 
be ordered by specifying OS/VS Reference Digest Package, BOF -3200 rather 
than individual order numbers. 


This publication does not contain information about program debugging or e 
control blocks. Refer to the OS/VS1 Debugging Guide, GC28-6670, the 

OS/VS1 System Data Areas, SY28-0605, the OS/VS2 Debugging Guide, 

GC28-0632, or the OS/VS2 System Data Areas, SY28-0606 to find this 

information. 


Third Edition (April 1973) 


This edition applies to Release 2 of OS/VS1, Release 1 of OS/VS2, and to all subsequent 

releases until otherwise indicated in new editions or Technical Newsletters. Changes are 
continually made to the information contained herein; before using this publication in 
connection with the operation of IBM systems, consult the JBM System/360 and System/3 '@ 
Bibliography, GA22-6822, and the IBM System/370 Advanced Function Bibliography, 
GC20-1763, for the editions that are applicable and current. 


Requests for copies of IBM publications should be made to your IBM representative or to 
the IBM branch office serving your locality. 


A form for reader’s comments is provided at the back of this publication. If the form has 
been removed, comments may be addressed to IBM Programming Publications, Dept. G60, 
P.O. Box 6, Endicott, New York 13760. Comments become the property of IBM. 
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Section 1: OS/VS General Information 
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System/370 Instructions 1-13 

OS/VS System Assembler Instructions, 
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EBCDIC Codes _ 1-63 





Source Publications 
Additional information about the System/370 and valid instructions 
is contained in JBM System/370 Principles of Operation, GA22-7000. 


Additional information about the OS/VS System Assembler is in 
OS/VS and DOS/VS Assenbler Language, GC33-4010. 
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Code Translation Table 











































































































































Instruction! Graphics and Controls 7-Track Tape 
Dec.| Hex (RR) BCDIC EBCDIC()) ASCII | BCDIC(2) Card Code Binary 
0; 00 NUL NUL 12-0-1-8-9 
1/01 SOH SOH 12-14 
2| 02 STX STX 12-29 
3} 03 ETX ETX | | 12-34 
4'04 | SPM PF EOT 12-4-9 
5|05 | BALR HT ENQ 12-5-9 
6| 06 | BCTR LC ACK 12-6-9 0000 0110 
7/07 _ | BCR DEL BEL | 12-7-9 0000 0111 
8/08 | SSK BS 12-8-9 0000 1000 
9:09 | ISK | HT 12-1-8-9 0000 100] 
10} 0A | SVC | SMM LF 12-2-8-9 0000 1010 
11 | OB | VT VT 12-3-8-9 0000 101] 
12, 0C FF FF 12-4-8-9 0000 1100 
13 | OD CR CR 12-5-8-9 0000 1101 
14) 0€ | MVCL SO sO 12-6-8-9 0000 1110 
15| OF | CLCL S| $] 12-7-8-9 0000 1111 
16; 10 | LPR DLE DLE 12-11-1-8-9 | 0001 0000 
17; 11 | UNR 0C1 DC1 11-1-9 0001 0001 
18) 12 | LTR 0Cc2 DC2 11-2-9 0001 0010 
19 | 13_ | LCR ™ DCc3 11-3-9 0001 0011 
20| 14 | NR RES DC4 11-4-9 0001 0100 
21; 15 | CLR NL NAK 11-5-9 0001 0101 
16 | OR BS SYN 11-6-9 0001 0110 
17_| XR | IL ETB 11-79 0001 0111 
24/18 | LR CAN CAN 11-8-9 , 0001 1000 
25/19 | CR EM EM 11-1-8-9 | 0001 1001 
26; 1A | AR cc SUB 11-2-8-9 0001 1010 
27| 1B | SR ees | cul ESC 11-3-8-9 0001 1012 
28|/1C MR IFS FS 11-4-8-9 0001 1100 
29|1D | OR IGS GS 11-5-8-9 0001 1101 
30| 1E | ALR IRS RS 11-6-8-9 0001 1110 
31) IF | SLR IUS US 11-7-8-9 0001 1111 
32120 |LPDR DS SP 11-0-1-8-9 0010 0000 
33 21 | LNDR SOs 1! 0-1-9 | 0010 0001 
34 22 | LTOR FS " 0-24 0010 0010 
35 23 | LCDR # 0-3-9 0010 0011 
36 | 24 | HOR BYP $ 0-4-9 0010 0100 
37 | 25 | LROR LF % 0-5-9 0010 0101 
38 | 26 | MXR ETB & 0-6-9 0010 0110 
39 | 27_ | MXDR ESC : 0-7-9 0010 011) 
40; 28 | LOR ( 0-8-9 0010 1000 
41| 29 | CDR ) 0-1-8-9 0010 1001 
42) 2A | ADR SM * 0-2-8-9 0010 1010 
43 | 2B | SDR CU2 + | 0-3-8-9 0010 1011 
44|2C | MDR j 0-4-8-9 0010 1100 
45| 2D | DDR ENQ = 0-5-8-9 0010 110) 
46 | 2E | AWR ACK : 0-6-8-9 0010 1110 
47 | 2F_ | SWR BEL / 0-7-8-9 0010 111] 
48 | 30 | LPER 0 12-11-0-1-8-9 | 0011 0000 
49 | 31 | LNER ] 14 0011 0001 
50/32 LTER 2 24 0011 0010 
51| 33 LCER 3 3-4 0011 0011 
HER 4 0011 0100 
LRER 2 0011 0101 
AXR 6 0011 0110 
55 | 37_ | SXR__ EOT 7 0011 0111 
1. EBCDIC graphics shown are standard 2. Add C (check bit) for odd or even 
bit pattern assignments. For specific parity as needed, except as noted. 
print train/chain see printer manual. 3. For even parity use CA. 
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Code Translation Table (con't) 








































































































Instruction Graphics and Controls 7-Track Tape 
Dec. Hex | (RR) BCDIC EBCDIC(1) ASCI! BCDIC(2) | Card Code | Binary 
56/38 LER | 8 8-9 0011 1000 
57139 CER 9 1-8-9 0011 1001 
58|3A | AER | ; 2-8-9 0011 1010 
59| 3B | SER CU3 ; 3-8-9 0011 1011 
60/3c | MER DCA < ae 0011 1100 
61|3D | DER NAK : 5-8-9 0011 1101 
62|3E | AUR > 6-8-9 0011 1110 
63 |3F_| SUR SUB 2 | 9 fon a 
64/40 | STH SP @ (3) ‘no punches | 0100 0000 
65/41 | LA A 12-0-1-9 0100 0001 
66 |42 | STC B 12-0-2-9 0100 0010 
67 43 | IC Ct 12-0-3-9 0100 0011 
68144 | EX D 12-0-4-9 "0100 0100 
69/45 | BAL E 12-0-5-9 0100 0101 
70 |46 | BCT F 12-0-6-9 0100 0110 
71 |47_| BC G ee | 0100 0111 
72/48 | LH H 12-0-8-9 0100 1000 
73 |49 | CH | 12-1-8 0100 1001 
74|4A | AH ¢ J | 12-2-8 0100 1010 
75 |48 | SH _ Hl K BA8 21 | 12-3-8 0100 1011 
76 |4C | MH = es tL 6 BA84 12-4-8 10100 1100 
77 |4D [ ( M BA84 1 | 12-5-8 0100 1101 
78 |4— | CVD < + N BA842_ | 12-6-8 0100 1110 
ae CVB # l 0 BA8421 | 12-7-8 | 0100 1111 
80150 | ST (a+ oR P BA 12 0101 0000 
81/5] Q 12-11-1-9 0101 0001 
82 | 52 R 12-11-29 0101 0010 
83 | 53 S {2-3-3 | 0101 0011 
84154 | N T 1 12-11-49 0101 0100 
85 FE CL U 12-11-59 0101 0101 
86/56 | 0 V 12-11-6-9 0101 0110 
87/57 | Xx W Bee | 0101 0111 
88158 1 L | x 12-11-89 0101 1000 
89 | 59 F Y 11-1-8 0101 1001 
90154 | A Z 1]-2-8 0101 1010 
91/58 |S $ $ [ B 8 21 | 11-3-8 0101 1011 
92/5¢ | M ‘ . \ B 84 1]-4-8 10101 1100 
9315D | D ] ) ] = B 84 1 | 11-5-8 010] 1101 
94/5E | AL : — *  B 842 /} 11-6-8 0101 1110 
95 |5F | SL A = = B 8421 | 11-7-8 0101 1111 
96 | 60 | STD - - . B Fl 0110 0000 
97 | 61 / / a A 1 | 0-1 0110 0001 
98 | 62 b 11-0-2-9 0110 0010 
99 | 63 eo! | 11-0-3-9 __| 0110 0011 
100 | 64 sar d 11-0-4-9 0110 0100 
101 | 65 e 11-0-5-9 | 0110 0101 
102 | 66 f 11-0-6-9 0110 0110 
103 67_| MXD q 11-0-7-9 0110 0111 
104 |68 | LD h | 11-0-8-9 | 0130 1000 
105 |69 | CD 0-1-8 0110 1001 
106 | 6A | AD : j 12-1] 0110 1010 
107 |6B | SD ‘ k A8 21 (038 _ | 0110 1011 
108 |6c | MD % ( % l | A84 0-4-8 0110 1100 
109 |6D | DD Y . m A84 1 |0-5-8 0110 1101 
110 | 6 | AW \ > n A842 | 0-6-8 0110 1110 
1 |6F | sw | ™ ? o | A8421 |0-7-8 _.0n0 111 
112 )70 STE D 12-11-0 "0111 0000 
1B !71 q '12-11-0-1-9 | 01110001 
114 | 72 r 12-11-0-2-9 | 01110010 
115 | 73_| s | 12-11-0-3-9 | 0111 0011 
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Code Translation Table (con’t) 





Instruction 
(RX) 


Graphics and Controls 
BCDIC EBCDIC(1) ASCII 















116 





ME 
DE 
AU 
Je 
SSM 


LPSW 
Diagnose 
WRD 
RDD 
BXH 
BXLE 

















92 


95 
96 
97 
98 


9A 
9B 
9C 
9D 
9E 
OF 
AO 
Al 
A2 








Ad 
AS 
A6 
Al 
A8 
AQ 
AA 
AB 
AC 
AD 





172 
173 
174 


175_| AF 


1-4 


7-Track Tape 
BCDIC(2) 


8 21 
84 

84 ] 
842 
8421 
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Card Code 
12-11-0-4-9 
12-11-0-5-9 


 12-11-0-6-9 
_12-11-0-749 


12-11-0-8-9 
1-8 

2-8 

3-8 

4-8 

5-8 

6-8 

7-8 
12-0-1-8 
12-0-1 
12-0-2 
12-0-3 
12-0-4 
12-0-5 
12-0-6 
12-0-7 
12-0-8 
12-0-9 
12-0-2-8 
12-0-3-8 
12-0-4-8 
12-0-5-8 
12-0-6-8 
12-0-7-8 
12-11-1-8 
}2-11-1 
12-11-2 
12-11-3 
12-11-4 
12-11-5 
12-11-6 
12--7 
12-11-8 
12-119 
12-11-2-8 
12-11-3-8 
12-11-4-8 
12-11-5-8 
12-11-6-8 
12-11-7-8 








Binary 

0111 0100 
0111 0101 
01110110 
0111 0111 
0111 1000 
0111 1001 
0111 1010 
0112 101) 
0111 1100 
0111 1101 
0111 1110 
O111 1111 
1000 0000 
1000 0001 
1000 0010 


_1000 0011 


1000 0100 
1000 0101 
1000 0110 
1000 0111 
1000 1000 


| 1000 1001 


1000 1010 
1000 1011 
1000 1100 
1000 1101 
1000 1110 
1000 1111 





_ 1001 0000 








1001 0001 
1001 0010 
100} 0011 
1001 0100 
1001 0101 
1001 0110 
1001 0111 
1001 1000 
1001 1001 
1001 1010 
1001 1011 
100} 1100 
1001 1101 
1001 1110 
1001 1111 
1010 0000 
1010 0001 
1010 0010 
1010 0011 
1010 0100 
1010 0101 
1010 0110 
1010 0111 
1010 1000 
1010 1001 
1010 1010 
1010 1011 
1010 1100 
1010 1101 
1010 1110 
1010 1211 




















Code Translation Table (con’t) 






Instruction 
(RS & SI) 




























Graphics and Controls 
BCDIC EBCDIC(1) ASCII 









7-Track 





—ZTOonmrnMolow rv 
—rlom™m™olowr»™ 





BCDIC(2) 


Tape 
Card Code 
‘12-11-0-1-8 
12-11-0-1 
12-11-0-2 
12-11-0-3 





12-11-0-8 
12-11-0-9 
12-11-0-2-8 
12-11-0-3-8 
12-11-0-4-8 
12-11-0-5-8 












12-11-0-6-8 
12-11-0-7-8 
2 12-0 
1 | 12-1 
2 12-2 
21 {12-3 


12-7 














12-8 
12-9 

12-0-2-8-9 
12-0-3-8-9 








cy 











Y 
} 
J J 
K K 
L L 
M M 
N N 
0 0 
P p 
Q Q 
R R 
rs \ 





x<s<cin 
xs<chHn 


Op code 
B202 - STIDP 
B203 ~ STIDC 
B204 - SCK 
B205 - STCK 








12-0-4-8-9 
12-0-5-8-9 
12-0-6-8-9 
_|12-0-7-8-9 








4 
4 
4 


OmwnwIwnwwaoww a 


8 
8 


11-0 
l]-1 
11-2 
11-3 
1-4 





1 
2 
21 


] 


11-5 
11-6 
U-7 
11-8 
N-9 
12~11-2-8-9 
12-11-3-8-9 





4 


| 12=11-4-8-9 


12-11-5-8-9 


|ie-i-1-8-9 


12-11-7-8-9 








oo 


Lae 


Kho PO 
— 


0-2-8 
11-0-1-9 
0-2 

0-3 


Binary 


1011 0000 
1011 0001 
1011 0010 
1011 0011 
1011 0100 
1011 0101 
1011 0110 
1011 0111 
1011 1000 
1011 1001 
1011 1010 
1011 1011 
1011 1100 
1011 1101 
1011 1110 
1011] 1111 
1100 0000 
1100 0001 
1100 0010 
1100 0011 
1100 0100 
1100 0101 
1100 0110 
1100 0111 
1100 1000 
1100 1001 
1100 1010 
1100 1011 
1100 1100 
1100 1101 
1100 1110 
1100 112) 
1101 0000 
1101 0001 
1101 0010 
1101 0011 
1101 0100 
1101 0101 
1101 0110 
1101 0111 
1101 1000 
1101 1001 
1101 1010 
1101 1011 
1101 1100 
1101 1101 
1101 1110 
1101 1111 
1110 0000 
1110 0001 
1110 0010 
1110 0011 





aa 
p> > >> > > 
aah 


aa 
wd 





NO PhO 
—_ 





1110 0100 
1110 0101 
1110 0110 


110011 
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Code Translation Table (con't) 


Graphics and Controls 
BCDIC EBCDIC(1) ASCII 














7-Track Tape 
BCDIC(2) Card Code Binary 


0-8 1110 1000 
A8 1 (0-9 1110 1001 
11-0-2-8-9 | 1110 1010 
{11-0-3-8-9 | 1110 1011 
11-0-4-8-9 | 1110 1100 
)11-0-5-8-9 | 1110 1101 
11-0-6-8-9 | 1110 1110 
‘11-0-7-8-9 | 1110 1111 





Instruction 
«| Hex (SS) 


ce | 














| 















































0 0 8 2 (0 1111 0000 

| MVO ] 1 1 1 1111 0001 
PACK 2 2 2 {2 1111 0010 
UN PK 3 3 21 3 1110011 
rl r ed if Ti1T 0100 

5 5 41 15 | 1111 0101 

6 6 42 16 11110110 

I= 7 7 421 |7 [41110111 
ZAP 8 8 8 8 1111 1000 
cP 9 9 8 1 19 1111 1001 
AP | 12-11-0-2-8-9| 1111 1010 
SP I2-11-0-3-8-9| 1111 1011 
MP 1 12-11-0-4-8-9! 1111 1100 
DP 12-11-0-5-8-9! 1111 1101 
12-11-0-6-8-9| 1111 1110 

| 12-11-0-7-8-9| 111] 1111 
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Machine Instruction Formats - Control Registers 
MACHINE INSTRUCTION FORMATS 


FIRST HALFWORD 1 SECOND HALFWORD 2 THIRD HALFWORD 3 


| 
REGISTER REGISTER 
| OPERAND 1 OPERAND 2 


| | Amn, 
an{_ovceae | At A? | 





cae ee ee eee 


0 ae 1112 15, 

| 

| REGISTER | ADDRESS OF 

Gren ane 1 | OPERAND 2 
cea [e~e@pe| 





4 1112 1516 1920 3 


REGISTER REGISTER ADORESS OF 
| CPERANE 1 OPERAND 3 OPERAND 2 


nsl_coome [mi [ra fe [ oe 


1 
| 
| 
| 
| 
l 
| 
| 
| 
i 
| 
: | | 
| 
| 
| 
l 
| 
| 
l 
| 




















1112 1516 1920 31 
nerer ADDRESS OF | 
OPERAND | OPERAND 1 | 
| a 
Topco [2 [et] | 
0 78 1516 1920 31 
| | OPERAND 1 , 
| 
ee 
ra) 15 16 920 l 
! | { | 
| LENGTH LENGTH ADDRESS OF ! ADDRESS OF 
| saigauierets 1 OPERAND 2 OPERAND 1 | OPERAND 2 
I 
Topco [it fiznsf er] or [2] 2 
1112 1516 1920 3132 3536 47 
ss<? te f ae 1 
I | { ADDRESS OF | ADDRESS OF | 
| LENGTH ing es OPERAND 1 | OPERAND 2 | 
1 
i 
1516 1920 3132 3536 
CONTROL REGISTERS 
CR | Bits Name of field Function or feature Reset 
0 0 Block-multiplex mode Block-multiplex’g control 0 
24 Timer mask 1 
25 Interrupt key mask Ext’d external masking 1 
26 External signal mask 1 
2 0-31 Channel masks Extended 1/O masking 1 
8 | 16-31 Monitor masks Monitoring 0 
14 '] Hard stop mode 1 
1 Synchronous MCEL mask 1 
2 1/O extended logout mask 0 
4 Recovery report mask 0 
5 Configuration report mask Machine-check handling 8) 
6 External damage report mask 1 
7 Warning mask 0 
8 Asynchronous MCE L mask 0 
9 Asynchronous fixed log mask 18) 
15 8-31 MCEL pointer Machine-check handling 512 
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Condition Codes 

CONDITION CODES 

Condition Code Setting 0 1 2 3 
Mask Bit Position 8 4 2 1 





Floating-Point Arithmetic 





Add Normalized S/L/E zero <zero >zero _ 
Add Unnormalized S/L zero <zero > zero _ 
Compare S/L (A:8) equal A low A high _ 
Load and Test S/L zero <zero > zero - 
Load Complement S/L zero <zero > zero _ 
Load Negative S/L zero <zero - - 
Load Positive S/L zero _ > zero ~ 
Subtract Normalized S/L/E —_ zero <zero > zero _ 
Subtract Unnormalized S/L zero <zero > zero - 


Fixed-Point and Decimal Arithmetic 





Add H/F/Dec. zero <zero > zero overflow 
Add Logical zero, not zero, zero, not zero, 
no carry no carry carry carry 
Compare H/F /Dec. (A:B) equal A low A high _ 
Load and Test zero <zero > zero — 
Load Complement zero <zero >zero overfiow 
Load Negative zero <zero _ _ 
Load Positive zero _ >zero overflow 
Shift and Round Decimal zero <zero > zero overflow 
Shift Left Single/Double zero <zero > zero overflow 
Shift Right Single/Double zero <zero > zero _ 
Subtract H/F/Dec. zero <zero > zero overflow 
Subtract Logical ~ not zero, zero, ‘not zero, 
no carry carry carry 
Zero and Add zero <zero >zero overflow 


Logical Operations 





AND zero not zero - _ 
Compare Logical (A:8) equal A low A high _ 

Edit zero <zero >zero -_ 

Edit and Mark zero <zero >zero _ 
Exclusive OR zero not zero — _ 
Insert Characters under Mask all zero 1st bitone Istbit zero — 
Move Long (A:8) equal A low A high overlap 
OR zero not zero _ _ 

Test under Mask zero mixed _ one 
Translate and Test zero incomplete complete _ 


input/Output Operations 





Halt 1/O, Hait Device interruption CSW stored see Prin Op not oper 
pending 
Start 1/0, SIOF started CSW stored busy not oper 
Store Channel ID ID stored CSW stored IDnotstored not oper 
Test 1/0 available CSW stored busy not oper 
Test Channel available interruption burst mode not oper 
pending 


Miscellaneous Operations 


Set Clock set secure _ not oper 
Store Clock set not set error not oper 
Test and Set zero one a _ 
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Codes for Program Interruption - CNOP Alignment - Edit and EDMK 
Pattern Characters 


CODES FOR PROGRAM INTERRUPTION 


Interruption F Interruption F 
Program Interruption Program Interruption 


Dec | Hex | Cause Cause 


Hex 

0001 Operation Decimal overflow 
0002 | Privileged operation Decimal divide 
0003 Execute Exponent overflow 


0004 | Protection Exponent underflow 
0005 | Addressing Significance 

0006 | Specification Floating-point divide 
0007 | Data Monitoring 

0008 Fixed-point overflow 

0009 Fixed-point divide 





OOAN OA BRAN — 


CNOP ALIGNMENT 


Double Word 


Half Word Half Word Half Word Half Word 


Byte 1 Byte + Byte ; Byte i Byte | Byte | Byte ; Byte 


0,4 2,4 0,4 4 
0,8 2,8 48 6,8 





EDIT AND EDMK PATTERN CHARACTERS (in hex) 


20-digit selector 40-blank 5C--asterisk 
21-start of significance 4B--period 6B--comma 
22-field separator 5B--dollar sign C3D9--CR 


Section 1: General Information 1-9 


Fixed Storage Locations 
FIXED STORAGE LOCATIONS* 


Area, 
dec. 


0-7 
8-15 
16-23 
24-31 
32-39 
40-47 
48-55 
56-63 
64-71 
72-75 
76-79 
80-83 
84-87 
88-95 
96-103 
104-111 
112-119 
120-127 
128-147 
148-149 
150-155 
156-159 
160-167 
168-171 
172-175 
176-179 
180-231 
232-239 
240-247 
248-251 
252-255 
256-351 
352-383 
384-447 
448-511 
§12- 


Hex 


addr 


200 


Purpose 


Initial program loading PSW, restart new PSW 
Initial program loading CCW 1, restart old PSW 
Initial program loading CCW2 

External old PSW 

Supervisor Call old PSW 

Program old PSW 

Machine-check old PSW 

Input/output old PSW 

Channel status word 

Channel address word 

Unused 

Timer (uses bytes 50, 51, and 52) 

Unused 

External new PSW 

Supervisor Call new PSW 

Program new PSW 

Machine-check new PSW 

Input/output new PSW 

Reserved 

Monitor class [0-7 zeros, 8-15 class number] 
Reserved 

Monitor code [0-7 zeros, 8-31 monitor code] 
Reserved 

Channel ID [0-3 type, 4-15 model, 16-31 max. IOEL length] 
1/O extended logout (IOEL) address [0-7 unused, 8-31 addr] 
Limited channel logout (see diagram) 

Reserved 

Machine-check interruption code (see diagram) 
Unused 

Failing processor storage address [0-7 zeros, 8-31 addr] 
Model-dependent 

Machine-check fixed logout area 

Machine-check floating-point register save-area 
Machine-check general register save area 
Machine-check control register save area 
Machine-check extended logout area (size varies) 


*Information from GA22-7000-1. Functions and use of fields beyond 127 may 
vary between models. See functional characteristics manual for specific model. 
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PSW - CAW - CCW - CSW 
PROGRAM STATUS WORD 


Protect’ i 
0 718 


11112 15/16 23124 31 













Mask * 

32 34 136 39140 47148 $5156 63 

O Channel 0 mask 13 (M) Machine check mask 

1 Channel 1 mask 14 (W=1) Wait state 

2 Channel 2 mask 15 (P=1) Problem state 

3 Channel 3 mask . 32-33 (ILC) Instruction length code 

4 Channel 4 mask . 34-35 (CC) Condition code 

5 Channel 5 mask 36 Fixed-point overflow mask 

6 Mask for channel 6 and up 37 Decimal overflow mask 

7 External mask 38 Exponent underflow mask 
12 Not used — must be zero 39 Significance mask 


*A& one-bit permits an interrupt. 


CHANNEL ADDRESS WORD (hex 48) 


Command Address 
0 3'4 7'8 15°16 23'24 31 


CHANNEL COMMAND WORD 


Command Code Data Address 
0 718 18'16 23'24 31 


a) a 


36137 39'40 47' 48 $5'S6 63 


CD—bit 32 (80) causes use of address portion of next CCW. 

CC —bit 33 (40) causes use of command code and data address of next CCW. 
SLI—bit 34 (20) causes suppression of possible incorrect length indication. 
Skip—bit 35 (10) suppresses transfer of information to main storage. 
PCI—bit 36 (08) causes a channel Program Controlled Interruption. 


CHANNEL STATUS WORD (hex 40) 


0 3°4 7°8 15°16 23°24 31 
32 39°40 47°48 §5'S6 63 
32 (8000) Attention 40 (0080) Program-controlled interruption 
33 (4000) Status modifier 41 (0040) Incorrect length 

34 (2000) Control unit end 42 (0020) Program check 

35 (1000) Busy 43 (0010) Protection check 

36 (0800) Channel end 44 (0008) Channel data check 

37 (0400) Device end 45 (0004) Channel control check 

38 (0200) Unit check 46 (0002) Interface control check 

39 (0100) Unit exception 47 (0001) Chaining check 


Byte Count: bits 48-63 form the residual count for the last CCW used. 


Section 1: General Information 1-11 








Limited Channel Logout 


LIMITED CHANNEL LOGOUT (hex BO) 


O}1 314 7 


Detect field 
4 CPU 
5 Channel 
6 Storage control unit 
7 Storage unit 








Source field 
8 CPU 
9 Channel 
10 Storage control unit 
11 Storage unit 
12 Control unit 


16-23 Field validity flags 
16 Interface address 


8 


1213 


900 | Fit ac tas [77 [00 [a So 


15416 23124 $26 [28|29 31 


17-18 Reserved (00) 
19 Sequence code 
20 Unit status 
21 Command address and key 
22 ,Channel address 
23 Device address 
24-25 (TT) Type of termination 
Code 00 Interface disconnect 
01 Stop, stack, or normal 
10 Selective reset 
11 System reset 
28 (A) 1/0 error alert 


29-31 Sequence code 
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UOTeUIOJU] [e1aUay 


€I-l 











5A RX Rl, D2(X2,B2) Add opr 2 to opr 1 0 Sum = 0 
(Sto) (Reg) 1 Sum < 0 
Fxpt Oflo 
ap lial 


2 Sum >0 
(GPR) (Reg) 
Add AP FA SS 
Decimal 
Data 
Dec Oflo 






3 Overflow 


0 Sum =0 
1 Sum < 0 
2 Sum >0 
3 Overflow 


























D1, (L2,B1), Add dec opr 2 to opr 1 0 Sum =0 

D2(L2,B2) (Sto) (Sto) 1 Sum <0 
(Right to left byte by byte). 2 Sum > 0 
(Opr 1 and 2 must be in packed) 3 Overflow 









(Fields can overlap if low-order 
bytes coincide) 

(If opr 1 and opr 2 refer to same 

field, the field is doubled) 

















AH 4A RX Rl, D2(X2,B2) Add opr 2 to opr 1 0 Sum =0 
ioe (Sto) (Reg) 1 Sum < 0 
(High-order 16 bits expanded) Fxpt Oflo 2 Sum > 0 

opr 2 3 Overflow 





Add Jog opr 2 to opr 1 
(Sto) (Reg) 









AL SE RX , D2(X2,B2) 
ee 
Add ALR 
Logical 


0 Sum = 0 
1 Sum #0 
2 Sum = 0 
3 Sum #0 








Add log opr 2 to opr 1] 
(Reg) (Reg) 
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O Fract =0 
1 Result < 0 
2 Result >0 
coe 


Format Operands Description 


FP Add opr 2 to opr | 

(FPR pair) (FPR pair) 
Extended sum is put in opr 1 (FPR pair) 
Each operand consists of two FPR 
Only FPR O and FPR 4 may be specified for 
opr | or opr 2. 


FP Add opr 2 to opr | 


Op Cat 


Add AXR 36 
Normalized 
(Extended) 






























































Add AD A RX R1, D2(X2, B2) Acc 0 Fract = 0 






Normalized (Sto) (FPR) Spec 1 Result < 0 
ilerg) Sign | 2 Result > 0 
Oo" 78 63 Exp Oflo | 3 -- 
Exp Uflo 
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0 Fract = 0 
1 Result < 0 
2 Result > 0 
Soe 


FP Add opr 2 to opr | 
(FPR) (FPR) 


Add 
Normalized 
(Long) 














z 
~ 
8 















0 Fract = 0 







Add X Rl, D2(X2, B2) FP Add opr 2 to opr | Acc 

















Normalized Sto FPR) Spec 1 Result < 0 
(Short) Sign 2 Result >0 
01 78 31 Exp Oflo | 3 -- 
Exp Uflo 





(Low-order halves of FPR ignored and 
unchanged) 

























Add RI, R2 FP Add opr 2 to opr | Spec 0 Fract =O 

Normalized (FPR) (FPR) 1 Result < 0 

(Short) Sign 2 Result > 0 
(Low-order halves of FPR ignored and Exp Oflo | 3 -- 
unchanged) Exp Uflo 





¥ 
ADR 2A e 











[| uonsag 


UOTBULIOJU] [eave 


tT 


g 





; 


Unnormalized 
(Long) 
2E 





Add R 


Unnormalized 
(Long) 


RX 


FP Add opr 2 to opr | 


R1, D2(X2, B2) 


(Sto ) 








RI, D2(X2, B2) 


FP Add opr 2 to opr 1 


(FPR) 


(FPR) (FPR) 


FP Add opr 2 to opr 1 


(Sto) 


(Low-order halves of FPR ignored and 


unchanged) 





Add Unnormalized 

Unnormalized 

(Short) 

Add A 
Unnormalized 

(Short) 


RI, D2(X2, B2) 


FP Add opr 2 to opr | 


(FPR) 


(FPR) (FPR) 


(Low-order halves of FPR ignored and 


unchanged) 


Place the product of both opr’s into opr 1 











AW 
AW 
AU 
UR 

N 
NC 
NR 
NI 


rep 


DI(L,B1), D2(B2) 





Place the product of both opr's into opr 1 
(Left to right byte by byte) 
(Max number of bytes ANDed: 256) 








Place the product of both opr's into opr 1 


Acc 
Spec 
Sign 
Exp Oflo 


Spec 
Sign 
Exp Oflo 








AND the 1 byte from the instruction stream 


(8-15) to opr 1 


O Fract = 0 
1 Result < 0 
2 Result >0 
Fas 


0 Fract = 0 
1 Result < 0 
2 Result > 0 
ee 


0 Fract = 0 
1 Result < 0 
2 Result > 0 
ae 


0 Fract = 0 
1 Result <0 
2 Result > 0 
Bess 


O Result = 0 
1 Result #0 


O Result = 0 
1 Result # 0 


O Result = 0 
1 Result #0 


0 Result = 0 
1 Result # 0 
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Cond Code 
Unchanged 


Exceptions 





Branch and BAL 45 RI, D2(X2, 62) Store ILC,CC prog mask, and 24 bits of 
Link inst adr in opr 1. Branch to adr of opr 2 
05 
47 
07 
















None 







(If opr 2 =0, store, no branch) 





RK 
Branch and BALR Vue Store ILC,CC prog mask, and 24 bits of 
Link 


inst adr in opr 1. Branch to adr of opr 2 
BC RX M1, D2(X2, B2) Compare opr 1 with cond code 
(Mask) 8-11 
R 


(Mask = 7) Branch on non~zero cond code 
(Mask = 15) Uncond branch 

(Mask = 8) Cond code 00 

(Mask = 4) Cond cede 01 

(Mask = 2) Cond code 10 


(Mask = 1) Cond code 11 


None Unchanged 
(NOP if cond not met) 


BC RR Compare opr 1 with cond code None Unchanged 
Branch to opr 2 adr if cond met 
(if opr 2 = 0) NOP 
BCT 46 RX R}, D2(X2, B2) Reduce opr | by ? and branch to opr 2 adr None Unchanged 
(if opr 1 = 1) Reduce, no branch 
BCTR RI, R2 Reduce opr 1 by 1 and branch to opr 2 adr None Unchanged 
(If opr 1 = 1) Reduce, no branch 
(If opr 2 = 0) Reduce, no branch 
RX, Ext. |02(X2, B2) Branch if mask = cond code None 
RX,Ext. |D2(X2Z, B2) Branch if mask = cond code None 


RS R1, R3, D2(B2) Add opr 3 to opr 1 ; None Unchanged 
Sum compared to opr 3 if opr 3 adr is od 
Sum compared to apr 3 + if opr 3 addr is 
even. Branch to opr 2 addr if sum > 
3/opr 3 +1 


Branch on 
Condition 
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Branch on 
Condition 


Branch on 
Count 

Branch on 
Count 

Branch on Equal 
Branch on High 


Branch on 
Index High 
























BE 
BH 
BXH 
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Operation 











Branch on Index 
Low or Equal 






Mnemonic [Op Cod ee a RE 
BXLE 87 RS Rl, R3, D2(B2) Same as Branch On Index High None Unchanged 
Branch to opr 2 adr if sum < or = opr 3+1 


D2 (X2, B2) Branch if mask = cond code None | Unchanged | 
D2 (X2, B2) Branch if mask = cond code None 
52 0, None 
Daa = 
BN 
NZ 










E 

H 
( [tec 1)| extn | 92 02) None 
176C 14) wx, Ext. | 92 02,0) None 





Branch on Not Zeros 47(BC 7) D2 (X2,B2) Branch if mask = cond code None Unchanged 


Branch if mask = cond code 


None Unchanged 





[eens Fm | 80 70-9 22 

[evcho Oveiow | 00 a7 [ase | DP 02 Nor 

Branch if Zeros | Bz -47(BC. 8) | RX, Ext. | D2 (X2, B2) Branch if mask = cond code None 

Branch Unconditional | BR | 47(BC 15)| RR, Ext. | R2 Branch if mask = cond code None 
Bell bald tad 


, D2(X2,B2) Compare opr 1 algebraically to opr 2 (Reg) Acc 
aoe Gi Ue 


Ext = Extended Mnemonic 


Branch if mask = cond code 

























BZ 
BZ 
Cc 

CR 






Compare opr | algebraically to opr 2 None 
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Dl (L1,B1), D2(L2,B2)}Compare opr 1 to opr 2 
(binary right to left) byte by byte 
(Opr's must be packed) 

(Fields can overlap if low-order bytes 
coincide) 

(The shorter opr is extended with high-order 
zeros) 


Compare Decimal 


a 
a 
- a 


: _ 
: ai 


; a — 









SS 























Compare opr 1 algebraically to opr 2 
(Hi-order 16 bits expanded) opr 2 








Compare Halfword 











Compare opr | to opr 2 
(binary left to right) 
(Terminates if/when # found) 


Compare Logical 















Compare opr | to opr 2 
(binary left to right) 

(Terminated if/when # found) 
(opr length max 256 bytes) 






Compare Logical 











Compare opr 1 to opr 2 
(Imm) (Sto) 

(binary left to right) 

(Terminates if/when # found) 









Compare Logical 













Compare opr | to opr 2 
(binary left to right) 
(Terminates if/when = found) 










Compare Logical 















Compare opr 2 to opr | under control 


Compare Logical 
of mask (binary left to right) 


Characters Under Mask 
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Operation Mnemonic 


Compare Logical Long CLCL 


2 


w “J N 
J 
~ 
3 
po} ae) al gall 
+ 


RT, R2 Compare opr 1 to opr 2 
(opr 1 and 2 indicate even/odd reg. pair) 
Compare (Long) R], D2(X2,B2) Compare opr | algebraically to opr 2 
(Equalize and subtract) 
R 
R 
R 





Compare (Long) 


Compare opr ] algebraically to opr 2 (FPR) 
(Equalize and subtract) 


I, 
1, 
1, 
1, 
1, 
1, 
1, 


Compare (Short) 


Compare (Short) 


R2 
D2(X2, B2) Compare opr | algebraically to opr 2 
(FPR) (Sto) 
(Low-order halves of FPR ignored and 
unchanged) 
R2 Compare opr ] algebraically to opr 2 
(FPR) (FPR) 
(Low-order halves of FPR ignored and 
unchanged) 
Convert to Binary R1, D2(X2,B2) Convert opr 2 (packed decimal ) Unchanged 
(Doubleword bounds) to binary and put in 
opr 1 location 
R1, D2(X2,B2) Convert opr 1 (binary) to packed decimal Unchanged 
(doubleword bounds) and put in opr 2 


See IBM System/370 | See IBM System/370 Unpredict- 
Principles of Opera- | Principles of Opera~ able 
tion, GA22-7000 tion, GA22-7000 


m 
x 


Convert to Decimal 


CVD 
~ | 
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Divide Decimal _ 









Rt, D2 (X2,B2) 











Di(L1,B1), 
D2(L2,B2) 





RX 
RR 
a 





















Divide opr 1 by opr 2 
(even and odd regs) (Sto) 
Opr 1 becomes quotient and remainder 


Divide opr 1 by opr 2 
Dividend: even and odd pair regs 

Opr 1 becomes quotient and remainder 
(full word only) 


Divide opr 1 by opr 2 
Opr 1 becomes quotient and remainder 
(left justified) 

Dividend: at least 1 leading zero, max 
size 3] digits and sign 

Divisor: max size 15 digits and sign, 
numerically larger than dividend 

Both opr's packed format 

Remainder size = divisor size (Fields can 
overlap if low-order bytes coincide. ) 








RI, D2(X2, B2) 





Divide (Long) 
Divide (Long) 








FP Divide opr 1 by opr 2 
(FPR) (Sto) 

Opr 1 becomes quotient 

(prenormalized) 


FP Divideopr 1 by opr 2 

Prenormalize (FPR) (FPR) 
(Dividend) (Divisor) 

Oper 1 becomes quotient 








































Cond Code 





Unchanged 
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T@- 








, D2(X2,B2) 


Divide (Short) 





. oH 


Divide (Short) 






Edit and Mark EDMK 


Exclusive OR eG 





DI(L,B1), D2(B2) 


D1(L,B1), 













D2(B2) 


, D2(X2,B2) 


















FP Divide opr 1 by opr 2 
Prenormalize 

(Dividend) (Divisor) 
Opr 1 becomes quotient 
(Low-order halves of FPR ignored and 
unchanged) 














Unchanged 
Unchanged 





FP Divide opr 1 by 2 
Prenormalize (FPR) (FPR) 

(Dividend) (Divisor) 
Opr 1 becomes quotient 
(Low-order halves of FPR ignored and 
unchanged) 


















Opr 1 = pattern, opr 2 = source Source 

Opr 2 is changed from packed to zoned and 0 field =C 
edited under control of opr 1. 1 field <0 
Opr's processed left to right Z field > 0 








(Fill char is Ist char in pattern field unless 
it is a digit/select/significance-s art char.) 
(Cpr 1 terminates operation) 

See IBM System/370 Principles of 
Operation, GA22-7000 
























Source 
G fielc =O 
lfeld <0 
2 fie! i > 0 


0 Resuit =C 
1 Result #0 


Same as Edit 
(Adr of Ist significant result digit 
recorded in GPR 1) 










Exclusive-OR opr 2 and opr | and the 
modulo-two sum placed in opr | 


Acc 
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ae os Cond Code 
Exclusive OR DI(L,B1), D2(B2) Exclusive-OR opr 2 and opr 1 and 0 Result = 
modulo-two sum placed in opr 1. | Result = 

Exclusive OR 0 Result = 
1 Result = 


Exclusive OR O Result =0 
Immediate 1 Result = 1 
Set by 
a executed 
instruction 


Halve, Long Opr 2 is divided by 2 and placed in Spec Unchanged 
opr 1. 
opr |. 


Halve, Short pe 
Halt Device DI ,(Bl) Execution of current |/O op at Priv 0 Subchan busy with another 
addressed dev is terminated dev or int pending 
(full op cd = 1001 1110 2000 xxx1) yep stored 
SENOS NLS 2 Chan working 
3 Not oper 
ttt , (Bl) Execution of current I/O op at c 0 Chan or sub- 















Exclustve-OR opr 2 and opr 1 and 
modulo-two sum placed in opr 1. 




















D1(B1), 12 Exclusive-OR opr 2 ond opr 1 and 


modulo-two sum placed in opr 1. 





















RI, D2(X2,B2) The instruction addressed by opr 2 


is modified by opr 1 ond executed. 
























Halt 1/O 









addresses dev, subchan, and chan term chan not working 

(full op cd - 1001 1110 xxxx xxx0). 1 CSW stored 

2 Burst oper 
terminated 

3 Not oper 


















Ponere | B2) Byte at opr 2 is inserted in high 


order byte of reg at opr 1. 


Unchanged 






insert Choracter 


insert Characters 
Under Mask 











RI, nioaiedl D2(B2) 0 Selected bits or mask= 0 
1 Leftmost bit of spec byte=1 


2 Leftmost bit of spec byte=0 


1 to 4 bytes at opr 2 are inserted 
in reg at opr 1 under control of 
mask. 
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ISK Opr 2, 8-20 fetches 7-bit sto key byte. Unchanged 
7-bit sto key is placed in opr 1, 24-30. Priv 
Bits 0-23 unchanged, 31 set to zero. Adr 
(opr 2, 0-7 and 21-27 ignored, 28-31 Spec 
must = 0 


Opr 1, 0-7 set to zero 


Load Address LA 4] RX Rl, D2(X2,B2) None Unchanged 
(no storage reference made) 

Load and Test LTR 12 RI, R2 Opr 2 into opr 1 None 0 Result = 0 
(When opr 1 and opr 2 specify same reg 1 Result < 0 
result is test without data transfer. ) 2 Result >0 

Load and 22 RR R1, R2 Opr 2 into opr 1 Spec O Result Fraction =0 
Test (Long) (FPR) (FPR) 

(When opr 1 and opr 2 specify same reg 

result is test without data transfer. ) 


1 Result < 0 
“ 











insert Storage 
Key 




















Opr 2, 12-31 to opr 1, 8-31. 
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O Result Fraction =0 
1 Result < 0 
2 Result > 0 







Opr 2 into opr 1 
(FPR) (FPR) 
(Low~order half of opr 1 unchanged) 
(When opr 1 and opr 2 specify same reg 
result is test without data transfer.) 






2 Result >0 
Test (Short) 

























Load Complement 2's complement of opr 2 into oper 1 Fxpt Oflo | O Result = 0 
(everflow when max negative number is 1 Result < 0 

complemented) 2 Result > 0 

3 Overflow 








SOSIC] DOUdIOJoyY S.JOUTWIeISOIg SA/SO ZI 


[Greraion | Mrenonic [Op Code [formar [Opens | ____Dweipion ——~=~—S—S*d;CR episod ne 


LCER 33 R1, R2 Opr 2 into opr | Spec 0 Result 
(FPR) (FPR) Fract =0 
(Opr 1 sign inverted, low-order half ] Result 0 
unchanged) 2 Result O 
(Opr 2 unchanged) 
LCDR 23 RI, R2 Opr 2 into opr 1 Same as Same as 
(FPR) (FPR) LCER LCER 
~~ 7 — 
48 RX Opr 2 halfword expanded to fullword 
with sign bits, placed in opr | 
ah 
ane 





Load Complement 
(Short) 


















Load Complement 
(Long) 
















(Low-order half of opr 1 unchanged) 







Cntl regs from opr | to opr 3 
loaded with info starting at 
opr 2. 
















(Opr 1 sign inverted, low-order half 
unchanged) 

Load Hal fword LH RI, D2(X2,B2) Acc Unchanged 
(High-order expanded) 

Load (Long) LD R1, D2(X2,B2) Opr 2 into opr 1 Acc Unchanged 
(Sto) (FPR) Spe 








(Opr 2 unchanged) 
FPR) (FPR 
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[Gwin [iors [ovens [ee [Gene [twin ei | on 


Load Multiple ai Opr 2 into GPRs in ascending order 
None 0 Result = 
1 Result < : 










2's complement of opr 2 into opr 1 
(Reg) (Reg) 

(If opr 2 contains a (-) number or zero, 

the number is unchanged) 









Starting reg specified by opr 1, ending 

reg specified by opr 3 

(Reg wrap-around possible) 
Result 
0 Fract = 0 
1 Result < 0 






RI, R2 Opr 2 into opr 1 
(FPR) (FPR) 








Opr 1 sign bit is 1 (negative) 
Orr 2 unchanged 


Load Negative LNER Rl, R2 Opr 2 into opr ] Spec 
(Short) Opr 1 sign bit is 1 (negative) 

Opr 2 unchanged 

(Low-order half of opr 1 unchanged) 






Result 
0 Fract =0 
1 Result < 0 



















0 Result = 0 





(Negative numbers are complemented) 





2 Result > 0 
3 Overflow 


Result 
0 Fract = 0 
2 Result > 0 


(Overflow occurs when the max negative 






number is complemented) 









(FPR) (FPR) 






Opr 1 sign bit made a zero (positive) 
Opr 2 unchanged 










Opr 2 into opr 1 
Load Positive LPDR 
(Long) 
Load Positive LPER 
(Short) 














Result 
0 Fract =0 
2 Result > 0 


Opr 2 into opr 1 
Opr 1 sign bit made a zero (positive) 
Opr 2 unchanged 

(Low-order half of opr 1 unchanged) 











Fxpt Oflo 
RI, R2 Opr 2 into opr 1 Spec 
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jso8Iq] 9USIOJay Ss JoWWILIZOIg SA/SO 9T-T 






Opr 1 into PSW Priv 
(Opr 1 low-order 3 bit adr must = 0) Acc 
(Instruction used to enter the problem or Spec 
wait state) 


Mnemonic Op Code 
LPSW 
R1, D2(X2, B2) Opr 2 into opr | Acc 
(Sto) (FPR) Spec 
(Low-order half of opr 1 unchanged) 
Opr 2 into opr | Spec 


(FPR) (FPR) 
(Low-order half of opr 1 unchanged) 
, D2(X2,B2) Real adr corresponding to opr 2 logical 0 Translation 
adr placed in opr 1. Priv available 
Adr 1 Seg tbl entry 
Trans invalid 
2 Page tbl entry 
invalid 
3 Seg or page tbl 
length violation 
, R2 Opr 2 is rounded from extended to long Unchanged 
format and put in opr | Spec 
(FPR pair) (FPR) Exp Oflo 
Only FPR 0 and FPR 4 may be specified 
for opr 2. 
, R2 Unchanged 
Spec 
Exp Oflo 


Load PSW 
Load (Short) 
Load (Short) 


Load Rea! Address al 


Load Rounded 
(Extended to Long) 














Set by new 
PSW 34 and 
35 








Unchanged 









Unchanged 
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Opr 2 is rounded from long to short format 
and put into opr 1 

(FPR) (FPR) 

Add an absolute | to opr 2, bit 32; carry 
will ripple left. 

Lower half of result FPR will remain un- 
changed. 


Load Rounded 
(Long to Short) 
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D1 (B1),I 


_ Tre 
a 7 ve 


Move MVI 


D1,(L,B1),D2 
(82) 


D1(B1), 


















Causes program interrupt if monitor- 
mask bit in cont. reg 8 = appropriate 
monitor class specified in positions 
12-15 of 12. Real storage locations 148 
and 156 will zero, loc 149=12, and loc. 
157-159=D1 + contents to Bl. 


Monitor Unchanged 
Spec 
at nel 


0 Opr cents = 
] Opr 1 cnt< 


Opr 2 to opr | 
(Left to right byte by byte) 





(Max number of bytes moved: 256) 
(No restriction on overlapping fields) 


Move the | byte from the instruction stream 
(8-15) to opr 1. 








Move char from area spec in opr 2 to area 
spec in opr 1], Opr 2 is even/odd reg pair 














where R2 is ''from adr'', R2+] bits O~7 is opr 2 cnt 
padding char, and R2+1 bits 8-31 is length. 2 Opr | cnt> 
Opr 1 is even/odd reg. pair opr 2 cnt 





3 No move due 
to destructive 
overlap. 


where R] is ''to'' addr, R1+1 
bits 8-31 is length. 











Ace 
Spec 
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Move with Offset im 


ml 
Multiply 








[weenonic [Op Gade [Forno [Opens | Deion ———————_—*Y’fsceptions | Cond Ca 


DI(L,B1), D2(B2) 







DI (L1,B1), 02 
(L2,B2) 


DI(L,B1), 02(B2) 















The 4 low-order bits of opr 2 bytes into the 
4 low-order bits of opr 1 bytes. 

(Left to right byte by byte) 

(Max number of bytes moved: 256) 
(High-order bits of each byte of both opr's 
unchanged. ) 

(No restriction on overlapping fields.) 




















Acc Unchanged 
Spec 


Opr 2 to the left of and adjacent to the 
low-order 4 bits of opr 1. 

(Right to left byte by byte) 

(Data can be packed, unpacked, or binary 
format ) 

(No restriction on overlapping fields) 
(Processing terminated by high-order bit 

in opr 1) 

(If opr 2 field shorter than opr 1, insert 
leading zeros in opr 2.) 
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The 4 high-order bits of opr 2 bytes into the 
4 high-order bits of opr 1 bytes 

(Left to right byte by byte) 

‘Max number of bytes moved: 256) 
(Low-order bits of each byte of both opr's 
unchanged. ) 

(No restriction on overlapping fields) 














Multiply opr 1 by opr 2 

Product: even and odd pair regs 

Opr 1 becomes the product. 

(Opr 1 must specify an even-numbered reg) 
(Sign bit extended to Ist significant product 
digit) 


















UOTPEUTIOJUYT [eIsUey) 2 UOTHD9$ 


ei 


67 








Multiply 1c 






Multiply (Extended) 





Multiply Decimal 












Di (L1,B1), 


D2 (L2,B2) 





Multiply opr 1 by opr 2 

Product: even and odd pair of regs 

Opr 1 becomes the product. 

(Opr 1 must specify an even-numbered reg) 
(Sign bit extended to Ist significant product 
digit) 
















Multiply extended opr 1 by extended opr 2 









(FPR pair) (FPR pair) Spec 
Extended product is put in opr | (FPR pair) Exp Oflo 
(Only FPR O and FPR 4 may be specified for Exp Uflo 


either opr 1 or opr 2) 

(Low~order characteristic is made 14 < 
high-order characteristic except when the 
result would be > 0, then the low-order 
characteristic is made 128 > its correct 
value; sign of low-order characteristic re- 
mains the same as high-order characteris- 
tic) 



















Multiply opr 1 by opr 2 






Multiplier: 8 bytes max size and shorter Acc 
than the multiplicand. Spec 
Multiplicand: must have high-order zeros Data 






equal to or greater than the size of the 
multiplier. 

(Both opr's in packed format) 

(Right to left byte by byte) 

Product: must contain at least 1 high-order 
zero. 



















Mnemonic Cond Code 


Unchanged 
Unchanged 
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Multiply Hal fword 





Multiply opr 1 by opr 2 

(Opr 2 is expanded to a 32-bit integer) 
(Only the low-order 32 bits of the product, 
opr 1, are retained) 

















Multiply opr 1 by opr 2 
(FPR) (Sto) 
Product: prenormalizes the opr's and post- 
normalizes the intermediate product. 
(If all fraction digits (15) = zero; the 
product, sign and char are made zero.) 
(The intermediate product fraction is 
truncated before left-shifting. ) 


Multiply (Long) 










us _ 
6C aul | D2(X2, B2) 
S| [ - 








Multiply opr 1 by opr 2 
(FPR) (FPR) 

Product: prenormalizes the opr's and post- 

normalizes the intermediate product. 

(If all fraction digits (15) = 0; the product 

sign and char are made zero.) 

(The intermediate product fraction is 

truncated before left-shifting. ) 







Multiply (Long) 







Multiply long opr 1 by long opr 2. 

(FPR) (Sto) 
Extended product is put in PFR pair speci- 
fied by opr 1 
(Only FPR O and FPR 4 may be specified 
for opr 1) 
(Signs of FPR pair are the same) 
(Can only use doubleword boundary in stor- 
age) 
(Continued) 





Multiply (Long to 
Extended) 












Acc 











Spec 


Exp Oflo 


Exp Uflo 





Unchanged 






















Unchanged 

















Unchanged 
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Multiply (Long to 
Extended) (Cont'd) 






aan - 
. ] 
yy 7 


Multiply (Long to 
Extended) 







Multiply (Short) 











normalizes the intermediate product. 
sign and char are made zero. ) 
cated before left-shifting. ) 


product always = zero.) 





(Low-order characteristic is made 14< 
high-order characteristic except when the 
result would be > 0, then the low-order 
characteristic is made 128 >its correct 
value; sign of low-order characteristic 
remains the same as high-order character- 
istics) 


















Multiply long opr 1 by long opr 2. 
(FPR) (FPR) 
Extended product is put in FPR pair 
specified by opr 1] 
(Only FPR 0 and FPR 4 may be specified 
for opr 1) 
(Signs of FPR pair are the same) 
(Low-order characteristic is made 14< 
high-order characteristic except when the 
result would be > 0, then the low-order 
characteristic is made 128> its correct 
value; sign of low-order characteristic 
remains the same as the high-order charac- 
teristic) 


Multiply opr 1 by opr 2 

(FPR) (Sto) 
Product: prenormalizes the opr's and post- 
(If all fraction digits (14) = 0; the product 


(The intermediate product fraction is trun- 


(The 2 low-order fraction digits of the 



















Unchanged 
Unchanged 
















Op Oo Cond Ca 
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Operands Description 




























Multiply (hort) MER 3G RR Multiply opr 1 by opr 2 Spec , 
(FPR) (FPR) Exp Oflo 
Product: prenormalizes the opr's and post- Exp Uflo 


normalizes the intermediate product. 
(If all fraction digits (14) = 0; the product 
sign and chor ore made zero.) 


(The intermediate product fraction is trun- 


Unchanged 
cated before left-shifting.) 


RX, D2(X2,B2) Comp mask with cond code None 
Ext. 

RR, R2 Comp mask with cond code None Unchanged 
Ext. 


RX R1, D2(X2, B2) The ORed sum of both opr's into opr 1 Ace 0 Result = 0 


oc Dé $$ D1(,B1),D2(B2) | The ORed sum of both opr's into opr | 
(Left to right byte by byte) 
(Max number of bytes ORed: 256) 






































Acc 0 Result = 0 
1 Result 4 0 

The ORed sum of both opr's into opr 1 None O Result = 0 

1 Result 4 0 

OR the 1 byte from the instruction stream Acc 0 Result = 0 
(8-15) to opr 1 1 Result 4 0 


Acc Unchanged 






D1(B1), 12 

















D1(L1,B1), 
D2(L2,B2) 


Change opr 2 from zoned to packed format 
and place into opr 1. 

(Right to left byte by byte) 

(No restriction on overlapping fields) 

(Opr 2 may be extended with hi-order zeros) 























Unchanged 





Ext, = Extended Mnemonic 


é i 
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cel 












Exceptions Cond Code 


ai “ _ 
Reset Reference a B213 i Di, Bl 
Bit 


Set Clock B204 D1(B1) 
Set Clock Compar- SCKC B206 $ D1(B1) 
ator 

Set CPU Timer 4 B208 D1(B1) 










The 1 byte from the instruction stream 
(8-15) is placed on the signal-out, ina 
form of 8 timing pulses, along with a 9th 
pulse at the read-out line. The 8 bit lines 
at the direct-in lines are stored in OQ or 1. 


Set refence-bit=0 for 2048 byte block 
referenced by opr 1. CC indicates setting Priv 
of ref and change bits prior to exec of this Adr 
instruction, 


Unchanged 





































0 Clock val set 
1 Clock val secure 
Die 

3 Clock not oper 


Replace curr val of TOD clock with eight 
bytes starting at opr 1. 















Dbiwd at opr | replaces curr value of clock 
comporator 


Unchanged 





DbIwd at opr | replaces curr value of CPU 
timer. 


Unchanged 
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Exceptions 





Set by bits 



















04 







ignored and unchanged.) 


Opr 1 (24-30) replaces the storage key 
specified by opr 2 
(Opr 1 bits 0-23 and 31 are ignored) 


2 and 3 
(Opr 2 bits 0-7 and 21-27 are ignored) 


Opr 1 (2-7) replaces the cond code and 
program mask bits of the current PSW 
Unchanged 
Priv 
Adr 
Spec 
(Bits 28-31 must be zero) 
D1(B1) Opr 1 (1 byte) replaces the system mask Priv Unchanged 
bits of the current PSW (0-7). Acc 


(18-23) (Bits 0, 1 and 8-31 of opr .1 are 
D1(L1,B1), Shift opr 1 as specified by opr 2. If shift 0 Result = 0 
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D2(B2), 13 is right, round by factor in opr 3. Ace 1 Result < 0 
Data 2 Result > 0 
Dec Oflo 3 Result Oflo 
8F R1, D2(B2) Opr 1 (even and odd regs) is shifted left Spec 0 Result = 0 
the number of times equal to opr 2 (low- Fxpt Oflo 1 Result < 0 
order 6 bits). 2 Result > 0 
3 Overflow 










Opr 1 (even andedd regs) is shifted left 
the number of times equal to opr 2 (low- 
order 6 bits). 

(Hi-order bit participates in the shift) 
Opr 1 is shifted left the number of times 
equal to opr 2 (low-order 6 bits), 





Shift Left Double 
Logical 









Fxpt Oflo 










0 Result = 0 
1 Result < 0 
2 Result > 0 
3 Overflow 


RI, D2(82) 
R1, D2(B2) 


© 
w 


Shift Left Single 
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Op Ca Cand Coe 


SIOF D1(B1) This instruction takes advantage of the Priv Same as SIO 
block-multiplex channel, but is otherwise 
identical to SIO. (Full op cd - 1001 
1100 xxxx xxx]). 


9C01 
4 ' 
Store Channel ID STIDC B203 D161) Store opr | at loc 168 in main storage. Priv 0 ID stored 
1 CSW stored 
2 Chan activity 
ID not stored 





Start 1/O Fast 
Release 
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: aon 
Store Character STC 42 R1, D2(X2,B2) Opr 1 (24-31) replaces the character at opr Unchanged 
2's address. 
Store Characters STCM RS R1, M3, D2(B2) Bytes selected from opr 1 under control of Unchanged 
Under Mask mask are stored at opr 2. 
















Store Clock STCK B205 D1(B1) Current val of TOD clock stored in 8 bytes Acc 0 Clock in set 

state 
1 Clk in not-set 

: state 

2 Clk in error 

3 Clk not oper 

or in stopped 
state 


at opr |. 
Store Clock Compar-| STCKC B207 Ace Unchanged 
ator Priv 
Spec 


Curr contents of clock comparator stored at 
opr | 


D111) 













UONeULIOJU] [eIaUEN : [| UONDES 


Le-l 












eT 





c 
[—Specin | Meme [Or Ge 


- 
Store CPU ID STIDP 


. 
~— mie 
ae 


a 





Store (Long) 
Store Multiple 








‘¢ 
D1 1) Curr contents of CPU timer stored in 
db! wd at opr 1. 








Ri, R3, D2(B2) Control regs from opr | to opr 3 stored at 





opr 2. 


CPU info stored in 8 bytes at opr 1. 






Opr 1 (16 low-order bits) is stored at opr 
2's location. 
(Hi-order bits, opr 1, ignored and un- 


R1, D2(X2,B2) 
changed) 
RI, D2(X2,B2) FP opr 1 to opr 2's location. 


R1, R3, D2(B2) 


Opr 1 thru opr 3 are stored at opr 2's 
location in ascending order. Starting reg 
specified by opr 1, ending reg specified by 
opr 3. 

(Reg wrap-around possible) 




























Priv 
Acc 
Spec 
Priv 
Acc 
Spec 
Priv 
Acc 
Spec 














Cond Code 


Acc Unchanged 
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Exceptions 


Cond Code 


Unchanged 






Op Code Format 
Store (Short) STE 70 RX R1, D2(X2,B2) FP opr 1 is stored at opr 2's location 
(Low-order half of FPR ignored and un- 
changed) 
Store Then AND STNSM AC D1(B1),12 
System Mask 
Store Then OR STOSM 4 S| D1@1), 12 























Acc 
Spec 














Bits 0-7 current PSWstored at opr 1, then 
these bits ANDed with opr 2 and replaced 
in current PSW, 


Unchanged 















Bits 0-7 of current PSW stored at opr 1, then 
these bits ORed with opr 2 and replaced in 
current PSW, 





Unchanged 






System Mask 



















































Subtract S B R1, D2(X2,B2) Subtract opr 2 from opr 1 and place the 0 Dif =0 
difference into opr 1. Acc 1 Dif <0 
Fxpt Oflo 2 Dif >0 

3 Overflow 
Subtract R1, R2 Subtract opr 2 from opr 1; difference Fxpt Oflo 0 Dif =0 
placed into opr |. 1 DiF< 0 
2 Dif >0 

3 Overflow 
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Subtract Decimal 














D1(L1,B1), D2(L2,82)| Subtract dec opr 2 from opr 1; 


difference stored into opr 1. 
(Right to left byte by byte) (Both opr's must 
be in packed format) (Fields can overlap if 
low-order bytes coincide) 





Subtract Halfword RI , D2(X2, B2) 


Opr 2 halfword expanded to fullword and 
subtracted from opr 1; difference placed 
into opr 1. 





RI, D2(X2, B2) 


Subtract Logical 








Subtract Logica! 


:] woroas 





Subtract Normalized 


UONPUNOJU] [RIdUd+) 


6€-1 











Subtract opr 2 from opr 1; 
difference placed into opr 1. 
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Subtract opr 2 from opr 1; 
difference placed into opr 1. 








FP subtract extended opr 2 from extended 
opr |, 

(FPR pair) (FPR pair) 
Extended difference is put in opr 1 (FPR 
pair) (Sign of extended opr 2 is inverted 
before the addition) 
(Only FPR O and FPR 4 may be specified 
for either opr 1 or opr 2) 
(Continued) 
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Cond Co 


(High-order and low-order signs of a FPR 
pair are always the same in extended 


precision) 
, D2(K2,B2 














‘Subtract Normalized 
(Extended) (Con't) 







(Low-order characteristic is made 14 < 
high-order characteristic except when the 
result would be > 0, then the low-order 
characteristic is made 128 > its correct 
value; sign of low-order characteristic 
remains the same as high-order charac- 
teristic) 



















Subtract Normalized FP Subtract opr 2 from opr 1 and the Result 
(Long) difference placed into opr 1. O Fract = 
(The sign of opr 2 is inverted before the 1 Result 20 
addition.) 2 Result > 0 
Bie 

















Result 
0 Fract = 0 
1 Result <0 
2 Result > 0 
3 Exp Oflo 


Result 








FP Subtract opr 2 from opr 1 
(FPR) (FPR) 

(The sign of opr 2 is inverted before the 

addition. ) 






Subtract Normalized 
(Long) 



















FP Subtract opr 2 from opr 1 






Subtract Normalized 














(Short) (The sign of opr 2 is inverted before the O Fract = 0 
addition. ) 1 Result < 0 
(Low-order halves of FPR ignored and 2 Result > 0 
unchanged), 3 Exp Oflo 
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Subtract Normalized 
(Short) 


Subtract 
Unnormalized (Long) 


Subtract 
Unnormalized (Long) 


Subtract 
Unnormalized (Short) 


Subtract 
Unnormalized (Short) 


RI, 


Subtract opr 2 from opr 1 

(The sign of opr 2 is inverted before the 
addition.) 

(Low~-order halves of FPRs ignored and 
unchanged) 


FP Subtract opr 2 from opr | 

(Sto) (FPR) 
(The sign of opr 2 is inverted before the 
addition. ) 


FP Subtract opr 2 from opr 1 

(FPR) (FPR) 
(The sign of opr 2 is inverted before the 
addition.) 


FP Subtract opr 2 from opr | 

(Sto) (FPR) 
(Low-order half of FPR ignored and 
unchanged) 
(The sign of opr 2 is inverted before the 
addition. ) 


FP Subtract opr 2 from opr | 

(FPR) (FPR) 
(Low-order halves of FPRs ignored and 
unchanged) 
(The sign of opr 2 is inverted before the 
addition. ) 


Result 

0 Fract =0 
T Result < 0 
2 Result > O 
3 Exp Oflo 


Result 

O Fract = 0 
1 Result < 0 
2 Result > 0 
3 Exp Oflo 


Result 

O Fract =0 
1 Result < 0 
2 Result > 0 
3 Exp Oflo 


Result 

O Fract =0 
1 Result < 0 
2 Result > 0 
3 Exp Oflo 


Result 

0 Fract =0 
1 Result < 0 
2 Result > 0 
—— 
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Immediate bits (8-15) placed in loc. 138 None Unchanged 
and PSW swap performed, 
(16-23) are made zero. 
(Old PSW at loc 32). 
(New PSW from loc 96). 










Supervisor Call 
















































Test and Set S! Hi-order bit of Ist byte of opr adr sets Acc 0 Hi~-order 
cond code. bit =0 
Entire byte then set to 1's 1 Hi-order 
bit =1 
vee 
Ace 









0 Chan Avi 
1 Int Pending 
2 Chan in 
Burst Mode 
3 Chan not 
Operational 



























Test Channel DI (Bl) Opr 1 (16-23) identifies the tested channel . Priv 
(Bits 24-31 are ignored. ) 
(instruction checks the channel's status 
and sets appropriate cond code.) 


a 





















Opr 1 (16-31) identifies the tested channel, 0 Available 

control unit, and |/O device. Used to clear 1 CSW 

a pending interrupt. Stored 
(CSW stored at loc 64): 2 Channel or 
Subchannel contains a pending interrupt. Subchan 
|/O device contains a pending interrupt. Busy 
Control unit or |/O device is executing a 3 Not 





previous operation or a pending chan- Operational 
nel-end/control unit-end for another 
\/O device. 

Channel or |/O device equipment error or 


device not ready. 
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ee 


Test Under ™ SI D1 (B1), 12 Immediate bits (8-15) used as a mask to 

Mask compare against opr 1. 

aaa 7 
yy 











0 Selected 
bits all 
zero (mask 
is all zero) 

1 Selected 
bits mixed 
O's and 1's 

3 Selected 

bits all 1's 













Mask bit 0: storage bit ignored. 









Opr 1 (argument byte) added to the initial Unchanged 
adr of opr 2 (24-31). This adr now is the 
loc of the function byte which replaces the 
original argument byte (left to right byte 
by byte) 

(All data is valid) 

(Oper is terminated when opr 1 field is 


exhausted) 
(Same as TR) 


































Mask bit 1: storage bit tested. 
Translate DI(L, 81), D2(B2) 







0 All 




























and Test When the function byte is a zero the next function 
argument byte is translated. Both opr's bytes 0 
remain unchanged. When the function byte 1 Non-0 
is a non-zero the operation is completed. function 
The generated argument adr is placed into byte met 
GPR 1, 8-31. Bits 0-7 remain unchanged. 2 Last 
The function byte is placed into GPR 2, 24- function 
31. (Left to right byte by byte). Bits 0-23 byte 
remain unchanged. non-0 
If opr 1 is exhausted before a non-zero cond, 3 Not used 


the opr is completed and GPRs 1 and 2 
remain unchanged. 
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Operation 
Unpack 


Write Direct 


Zero ond Add 








eye cod Gn 








A 












DI(L1,B1), D2(L2,B2)| Change opr 2 from packed to zoned format Acc Unchanged 
and place into opr 1. 


(Right to left byte by byte) 
(No restrictions on overlapping fields) 
(Opr 2 may be extended with hi-order zeros. ) 

D1 (L1,B1), D2(L2,B2) | Opr 1 cleared and opr 2 placed in opr | O Result = 
(Low-order opr's may coincide) 1 Kesult< : 
(Opr 2 must be in packed format) 2 Result > 0 
(Opr 1 field must be large enough for all 3 Overflow 
opr 2 significant digits) 
(Opr 2 extended with zeros to fill opr 1.) 







D1 (BI), 12 The 1 byte from the instruction stream 
(8-15) is placed on the timing signal out, 
in a form of 8 timing pulses, along with 
a 9th pulse at the write-out line. 

The 8 bit lines at the direct-out lines are 


brought up by opr 1. 
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OS/VS System Assembler Instructions 


ACTR 





AGO 


AIF 


ANOP 





CCW 


CNOP 


COM 





COPY 
CSECT 
CXD 


DC 


DROP 


DS 


DSECT 


DXD 


EJECT 


END 


ENTRY 


EQU 


EXTRN 


GBLA 





GBLB 





Blank 

A sequence symbol 
or blank 

A sequence symbol 
or blank 

A sequence symbol 


or blank 


Any symbol or blank 


Any symbol or blank 


Any symbol or blank 
Must not be present 
Any symbol or blank 
Any symbol or blank 
Any symbol or blank 


A sequence symbol 
or blank 


Any symbol or blank 


Any symbol or blank 
Any symbol 

A sequence symbol 
or blank 


A sequence symbol 
or blank 


A sequence symbol 
or blank 


An ordinary symbol 
or a variable symbol 


A sequence symbol 
or blank 


Must not be present 


Must not be present 





A SETA expression 


A sequence symbol 


A logical expression enclosed 
in parentheses, immediately 
followed by a sequence symbol 


Must not be present 
Four operands, separated by 
commas 


Two absolute expressions, 
separated by a comma 


Must not be present 
One ordinary symbol 
Must not be present 
Must not be present 


One or more operands, separated 
by commas 


One to sixteen absolute 
expressions, separated by 
commas; or blank 


One or more operands, separated 
by commas 


Must not be present 


One or more operands, separated 
by commas 


Must not be present 


A relocatable expression or 
blank 


One or more relocatable symbols, 
separated by commas 


One to three operands, 
separated by commas 


One or more relocatable symbols, 
separated by commas 


One or more variable symbols 
that are to be used as,SET symbols, 
separated by commas 


One or more variable symbols 
that are to be used as SET 
symbols, separated by commas 


Section 1: General Information 1-45 


OS/VS System Assembler Instructions (con't) 


Must not be present 








One or more variable symbols 
that are to be used as SET 
symbols, separated by commas 










One to three decimal values, 
separated by commas 





Must not be present 










Must not be present 





Not present or a blank 








Must not be present One or more variable symbols 
that are to be used as SET 


symbols, separated by commas 










One or more variable symbols 
that are to be used as SET 
symbols, separated by commas2 


Must not be present 






Must not be present One or more variable symbols 
that are to be used as SET 


symbols, separated by commas? 










Any symbol or blank Must not be present 


Must not be present Must not be present 









A sequence symbol 
or blank 


Must not be present 










A sequence symbol 
or blank 


Must not be present 










A severity code followed by a 
comma (this much is optional) 
followed by any combination of 
characters enclosed in 

apostrophes 


A sequence symbol 
or blank 















An ordinary symbol A machine instruction mnemonic 
code, an extended mnemonic code, 
a macro operation, an assembler 
Operation, an operation code 
defined by a previous OPSYN 


instruction, or blank 












Any symbol or blank 





A relocatable expression or 
blank 














One or more operands, separated 
by a comma 


A sequence symbol 
or blank 








A sequence symbol 
or blank 


One to three operands 












A sequence symbol 
or blank 


One to eighty characters, 
enclosed in apostrophes 












One or more operands, separated 
by a comma 


A sequence symbol 
or blank 








A sequence symbol 
or blank 





Must not be present 





A SETA symbol An arithmetic expression 










A SETB symbol AOQoral, a SETB symbol, variable 
symbols except &SYSLIST, or a logi- 


cal expression enclosed in parentheses 
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OS/VS System Assembler Instructions (con't) 


A SETC symbol A duplication factor (a SETA 
expression enclosed in parentheses) 
if desired, followed by a type 
attribute, a character expression, 
a substring notation, or a 
concatenation of character 
expressions and substring 
notations 


A sequence symbol A decimal self-defining 
or blank term or blank 


Any symbol or A self-defining term or blank 
blank 


A variable symbol, One to 100 characters, enclosed 
alphameric character in apostrophes 

string, or a combination 

of variable symbol and 

character string, ora 

sequence symbol, or a 

blank. 


A sequence symbol An absolute or relocatable 

or blank expression followed by 1 to 16 
absolute expressions, separated 
by commas 


A sequence symbol One or more relocatable 
or blank symbols, separated by commas 





‘Can be used only as part of a macro definition. 
2ceT symbols can be defined as subscripted SET symbols. 
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OS/VS System Assembler Statements 


Instruction 


Model Statements 


Prototype Statement | 


Macro-l nstruction 


Statement 


Assembler Language 
Statement 


An ordinary symbol, 
a variable symbol, 
a sequence 

symbol, a combina- 
tion of variable 
symbols and other 
characters that is 
equivalent to a 
symbol, or blank 


A symbolic para- 
meter or blank 


An ordinary symbol, 
a variable symbol, 
a sequence symbol, 
a combination of 
variable symbols 
and other charac- 
ters that is equiv- 
alent to a symbol, 


or blank 


An ordinary symbol, 
a variable symbol, 
a sequence symbol, 
a combination of 
variable symbols 
and other charac- 
ters that is equiv- 
alent to a symbol, 
or blank 


Any combination of char- 
acters (including 
variable symbols) 


Zero or more operands 
that are symbolic parameters, 
separated by commas 


Zero or more positional 
operands and/or zero 

or more keyword operands 
separated by commas 


Any combination of charac- 
ters (including variable 


symbols) 





‘Can only be used as part of a macro definition. 


Variable symbols appearing in a macro instruction are replaced 
by their values before the macro instruction is processed. 
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OS/VS System Assembler Constants 


NUMBER 
OF CON- TRUN- 
IMPLICIT STANTS RANGE CATION/ 
LENGTH ; ALIGN- SPECIFIED | PER FOR EX- PADDING 
TYPE} (BYTES) MENT BY OPERAND | PONENTS SIDE 


1 to characters 
conde 256 (1) 
byte -l to hexodecimal left 
ages 256 (1) | digits 
os byte binary multi- left 
needed digits ple 
word decimal -85 to -187 to | left (3) 
digits 475 +346 
2 hol f 1 to decimal ~85 to -187 left (3) 
word 8 digits 475 +346 
4 word decimal multi- -85 to right (3) 
digits ple +75 0-14 
double decimal -85 to right (3) 
word digits +75 0-14 
L double ,l to decimal multi- ~B5 to 0-28 right (3) 
word 16 digits ple +75 
os byte decimal left 
needed digits 
Zz as byte decimal 
needed digits 
J te ony left 
4 (2) expression 
word 1-4 symbo} nom- left 
ing o DXD 
relocatable left 
symbol 
two obsalute 
expressions: 
3 or 4 bytes only; relocatable Y-type constants, 2 bytes only. 
(3) Errors will be flagged if significont bits ore truncated or if the value specified cannot be con- 


or DSECT 
(ieee aa 2 only one absolute 
word 
exp (exp) 
tained in the implicit length of the constont. 























































or relocat- 
hol f 1 to any left 
word 2 (2) expression 


able ex- 

pression or 
(1) Ino DS assembler instruction C and X type constants can have length specification to 65535, 
(2) Bit length specification permitted with absolute expressions only. Relocatable A-type constants, 
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PLEASE COMMENT 


Use Reader’s Comment Form 
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Variable Symbols 


Global SET Symbols Local SET Symbols 
Statement SETA SETA SETB SETC 8&SYSNDX | &SYSECT 


eae eee ee teeta tn 
ne rae 


Symbolic 
Parameter 


SETB SETC 





Prototype Nome 
Statement Operand 








Operand 


GBLA Operand 
GBLB 


ae 
a 








Operand 





System Voriable Symbols 


&SYSPARM | &SYSDATE | &SYSTIME 





8&SYSLIST 





OS/VS System Assembler Macro Language Statements 


Attributes 


Type Number 





of 

















LCLB 
LCLC 


ie | eae eee 

at ae Resa oes? 
faa fp i =< 

een sae aaa! 










































Model Name Name Name Name | Name Name 
Statement Operation | Operation | Operation | Operation | Operation | Operation | Operation | Operation | Operation 
Operand | Operand Operand | Operand Operand | Operand Operand | Operand Operand 





Name 


Operand 


z 
Q 
3 
r 








Crerand” Opeiend” 


SETA 
Operand | Operand 

SETB 6 6 6 6 
Operand | Operand Operand” | Operand Operand 

SETC 7 8 Name 7 8 Name 
Operand | Operand Operand Operand’ | Operand Operand 


i Cpercad® Operand Opeind” ot Operand Operand Cpstand” 
2 3 
ACTR Qperand” | Operand Operand 


5 Operon” Operand 
eat a 












Name. 








SE 








O 
ae] 
® 
bad 
Q 
2 
QW 





Operand 




























~ Operond 





Operand 





























Sequence 
Symbol 














Nome Name 
Operation | Operation 
Operand Operand | Operand | Operand 








Oparand’ 





6 


oO 





Operand Operond | Operand | Operand 


Operand” Operand” 





Gpateid Oper sae 
Operand 


Operand 





Operand | Operand 


q 
Qu. 


Ope 


Operand 





5 
3 





Zz 
Q 
3 
® 


g 


Operan £ 











| 7 


erand 


On er and 


Zz 
Q 
3 
@ 

















Name 












Operand Operand | Operand | Operand 


Name 






























Name 


Operand 


AIF 
AGO 
MNOTE Operand 
Name 
Operand 





Outer Name 
Macro Operand 



















Iner Name Name Name Nome Name Nome 
Macro Operand Operand | Operand Operand | Operand 









































Assembler Name Name Name Name Name Name 
Language Operation | Operation| Operation | Operation | Operation | Operation 
Statement Operand Operand | Operand Operand | Operand Operand 


Variable symbols in macro instructions are replaced’by their values before processing . 
Only if value is self-defining term. 

Converted to arithmetic +1 or +0. 

Only in character relations. 

Only in arithmetic relations. 

Only in arithmetic or character relations, 

Converted to unsigned number. 

Converted to character 1] or 0. 

Only if one to one decimal digits from 0 through 2, 147, 483, 647). 


* 


1 

2. 
Se 
4. 
oe 
é. 
ce 
8. 
van 









Operand | Operand 








Name 
Operand 


Name 
Operand 


Name 


Operand Operand 


Operand 


Operand 
Name 

















Section 1: General Information 





1-5] 


OS/VS System Assembler Conditional Assembly Expressions 


Arithmetic Expressions | Character Expressions | Logical Expressions 










Can contain @ Self-defining terms @ Any combination of | eA0 ora | 
characters enclosed 
@ Length, scaling, in apostrophes @ SETB symbols 


integer, count, and 
number attributes 













@ SETA and SETB @ Any variable symbol | @ Arithmetic 
symbols enclosed in relations 
apostrophes 





@ SETC symbols whose eA concatenation of | e Character 


values are a decimal variable symbols and | relations 
self-defining term other characters 
enclosed in 


apostrophes 







@ &SYSPARM if its @ Variable symbols 


value is a decimal except &SYSLIST 
self-defining term 













@ Symbolic parameters 
if the corresponding 
operand is a decimal 
self~defining term 







@ A type attribute 
reference 


o &SYSLIST (n) if the 
corresponding 

operand is a decimal 
self-defining term 


@ &SYSLIST (n,m) if 
the corresponding 


operand is a deci- 
mal self-defining 
term 


@ &SYSNDX 












Operations +, - (unary and bi- concatenation, witha | AND, OR, and NOT 
are nary), *, and /; period (.) parentheses per- 
parentheses per- mitted 
mitted 
31. 3] 
Range “2 tot2 ~} O through 255 charac- | 0 (false) or 
of values ters 1 (true) 











May be @ SETA operands @ SETC operands e@ SETB operands 
used in 2 
e Arithmetic relations @ Character relations” | @ AIF operands 


@ Subscripted SET 
symbols 


© SYSLIST subscript (s) 
® Substring notation 


@ Sublist notation 


} : : , ‘ ; 
An arithmetic relation consists of two arithmetic expressions related by the 
operators GT, LT, EQ, NE, GE, or LE. 


24 character relation consists of two character expressions related by tne 
operator GT, LT, EQ, NE, GE, or LE. Type attribute aotation and Sub- 
string notation may also be used in character relations. The maximum 
size of the character expressions that can be compared is 255 characters. 
If the two character expressions are of unequal size, the smaller one will 
always compare less than the larger. 
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OS/VS =e Assembler Attributes 


Ordinary Symbols de- premiere always be used) 
fined in Open Code; 
symbolic parameters 
inside macro defini- 
tions; SET symbols, 
&SYSPARM, 
&SYSDATE, 

&SY STIME, inside 
or outside macro 
definitions; 
&SYSLIS1 (m), 
&SYSLIST (m,n), 
&SYSECT, 

&SYSN DX inside 


macro definitions 


Ordinary Symbols Any letter except 
defined in Open M,N,0O,T and U 
Code; symbolic 

parameters inside 

macro definitions; 

&SYSLIST (m), and 

&SYSLIST (n,n) in- 

side macro definitions 


Ordinary Symbols H,F,G,D,€,L,K,P, 
defined in Open and Z 

Code; symbolic 

parameters inside 

macro definitions; 

&SYSLIST (m), and 

&SYSLIST (m,n) in- 

side macro definitions 


Ordinary Symbols de-|H,F,G,D,E,L,K,P, 
fined in Open Code; |and Z 

symbolic parameters 

inside macro defini- 

tions; &SYSLIST (m;, 

and &SYSLIST (m,n) 

inside macro de- 

finitions 


Symbolic parameters 
inside macro defini- 
tions; SET symbols; 
all system variable 
symbols 


Symbolic parameters, |Any letter 
&SYSLIST (m), and 

&SYSLIST (m,n) in- 

side macro definitions 


1, SETC operand 


fields 
2. Character 
relations 


Arithmetic 
expressions 


Arithmetic 
expressions 


Arithmetic 
expressions 


Arithmetic 
expressions 


Arithmetic 
expressions 
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OS/VS System Assembler Variable Symbols 


Variable | Declared by: | Initialized, Value changed May be used in: 
Symbol or set to: by: 
1 


Symbolic | Prototype Corresponding | (Constant @ Arithmetic 
Parameter | statement macro instruc= | throughout expressions 
tion operand definition) if operand 
is decimal 
self-defining 
term 


































e Character 
expressions 
















LCLA or 
GBLA 


instruction 


SETA 


instruction 


@ Arithmetic 
expressions 






oe Character 
expressions 














LCLB or 
GBLB 


instruction 


SETB 


instruction 


@ Arithmetic 
expressions 





e Character 
expressions 





© Logical 
expressions 




























LCLC or String of SETC e Arithmetic 
GBLC length 0 instrucfion expressions 
instruction (null) if value is 


decimal self- 
defining term 


eo Character 
expressions 

































Macro (Constant @ Arithmetic 
instruction throughout expressions 
index definition; 






e Character 
expressions 


unique for 
each macro 





&SYSNDX || The assembler 





























instruction) 
8SYSECT! The assembler | . Control (Constant e@ Character 
section in throughout expressions 
which macro definition; 
instruction set by CSECT, 
appears DSECT, START, 
and COM) 
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OS/VS System Assembler Variable Symbols (con’t) 


Variable Declared by: initialized, Value changed | May be used in: 
Symbol or set to: by: 
&SYSLIsT! The assembler e N'8SYSLIST in 
cals Siete arithmetic 
expressions 


BSYSLIST The assembler 
(n) 
&SYSLIST 
(n,M) 

&SYSPARM | PARM field 


&SYSTIME | The assembler 






























Corresponding | (Constant e Arithmetic 










macro instruc- | throughout expressions 
tion operand definition) if operand 
is decimal 






self-defining 
term 










e Character 
expressions 
















User defined 
or null 






e Arithmetic 

expression 
if value is 
decimal self- 
defining term 


Constant 
throughout 
assembly 



















e Character 
expression 










Constant 
System time throughout 
assembly 






e Character 
expression 













&SYSDATE | The assembler | System date | Constant e Character 
throughout expression 
assembly 





lean be used only in macro definitions. 
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Hexadecimal and Decimal Conversion 


From hex: locate each hex digit in its corresponding column position and note the decimal 
equivalents. Add these to obtain the decimal value. 


From decimal: (1) locate the largest decimal value in the table that will fit into the decimal 
number to be converted, and (2) note its hex equivalent and hex column position. (3) Find 
the decimal remainder. Repeat the process on this and subsequent remainders. 





0 
1,048, 576 
2,097, 152 
3,145, 728 
4,194,304 
5,242, 880 
6,291, 456 





7,340,032 
8, 388, 608 
9, 437, 184 
10, 485, 760 
11, 534, 336 
12,582,912 
13,631, 488 
14,680,064 
15,728, 640 
‘0123 «| —4567 | oma ~~ StS =| OS —«d:CSS 


BINARY CONVERSION 





TAMONTPOMNOUMRON—O 
T™MONFTPOMNAUMARWH—O 











: 


16 777 216 

268 435 456 

4 294 967 296 

68 719 476 736 

1 099 511 627 776 

17 592 186 044 416 

281 474 976 710 656 

4 503 599 627 370 496 

72 057 594 037 927 936 

1 152 921 504 606 846 976 


OWN FM WH — © 
ODN AM & WH — © 
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Hexadecimal Addition, Multiplication, Subtraction Tables 


Hexadecimal Addition and Subtraction Table 


= 2 


8, 8-2=6, and8 -6 


Example: 6 + 2 





Hexadecimal Multiplication Table 


1E 


08, Fx 2= 


Example: 2 x 4 








Ul] ca SIS 
wi 25 


N xs Qo} y uy 3s $s 
We) as c9| 64] 
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Decimal to Hexadecimal Conversion Information 


Decimal to Hexadecimal Conversion: Locate the decimal fraction {.1973) in the table. If the exact 
figure is not shown, locate the next higher and lower fractions (.19726563, .19750977). The first 
digits of the hexadecimal fraction are at the top of the column (:32). To locate the third digit, deter. 
mine by observation or subtraction the smaller difference between the known fraction and each of 
the found fractions. The smaller difference identifies the correct line (.008). The hexadecimal equiva- 
lent is .328. 

If more places to the right of the decimal point are required in the hexadecimal fraction, multiply 
the decimal fraction by 16 and develop integers as successive terms of the hexadecimal fraction. 
Using the previous sample decimal fraction: 


Developed 
Integers 


5088 197319 = 328246 





Hexadecimal to Decimal Conversion: Locate the first two digits (.1E} of the hexadecimal fraction 
(.1E9) in the horizontal row of column headings. Locate the third digit (.009) in the left most 
column of the table. Follow the .009 line horizontally to the right to the .1E column. The decimal 
equivalent is .11938477. The decimal fractions in the table were carried to eight places and rounded. 
If 2 places are required, or if the hexadecimal fraction exceeds the capacity of the table, express the 
hexadecimal fraction as powers of 16 (expansion). For example: 


E9446 = 1(16'') + 14(16°2) + 9(16°9) + 4(16°4) 


= 1(.0625) + 14(.00390625) + 9(.000244440625) + 4(.0000152587890625) 


= .119445800781 250019 


1-58 OS/VS Programmer’s Reference Digest 




















.000 
.001 

-002 
003 
-004 
.005 
-006 
.007 
.008 
009 
-00A 
.00B 
.00C 
.00D 
.Q0E 

OOF 


.000 
-001 
.002 
.003 
.004 
.005 
.006 
.007 
.008 
.009 
.00A 
.00B 
.00C 
.00D 
7O0E 
. OOF 


.000 
001 
-002 
.003 
-004 
.005 
.006 
.007 
-008 
.009 
-O0A 
-00B 
-00C 
.00D 
.O0E 
OOF 


-000 
.001 

.002 
-003 
004 
-005 
006 
.007 
.008 
.009 
.O0A 
008 


.00D 
.O0E 
OOF 

















.00 01 02 
00000000 "00390625 00781250 
00024414 .00415039 00805664 
00048828 .00439453 .00830078 
.00073242 .00463867 00854492 
00097656 .00488281 .00878906 
.00122070 .00512695 00903320 
00146484 .00537109 00927734 
.00170898 .00561523  .00952148 
.00195313 .00585938 00976563 
,00219727 .00510352 —.01000977 
0024414] .00634766 ——-.01025391 
00268555 .00659180 —.01049805 
00292969 .00683594 —.01074219 
00317383 .00708008 —.01098633 
,00341797 .00732422 —.01123047 
00366211 00756836 01147461 

"10 i 12 
"06250000 "06640625. .07031250 
06274414 .06665039  .07055664 
06298828 .06689453  .07080078 
06323242 .06713867 —.07104492 
06347656 .06738281  .07128906 
06372070 .06762695 .07153320 
06396484 .06787109  .07177734 
06420898 .06811523 _,07202148 
06445313 .06835938 —-.07226563 
06469727 .06860352  .07250977 
0649414] .06884766 —-.07275391 
06518555 .06909180  .07299805 
06542969 .06933594 .07324219 
06567383 .06958008  .07348633 
06591797 .06982422  .07373047 
06616211 .07006836__.07397461 

20 21 22 
. 12500000 "12890625. 13281250 
12524414 .12915039 13305664 
. 12548828 . 12939453. 13330078 
12573242 .12963867 —-. 13354492 
12597656 , 12988281 —-. 13378906 
. 12622070 13012695. 13403320 
12646484 .13037109 —-. 13427734 
. 12670898 .13061523  .13452148 
12695313 . 13085938 =. 13476563 
12719727 .13110352.-. 13500977 
12744141 .13134766 13525391. 
12768555 .13159180 13549805 
12792969 . 13183594 13574219 
12817383 . 13208008 —-. 13598633 
. 12841797 . 13232422 13623047 
12866211 13256836 __, 13647461 

30 KT "32 
18750000 -19140625 19531250 
18774414 .19165039 19555664 
18798828 .19189453 . 19580078 
18823242 . 19213867. 19604492 
. 18847656 .19238281 . 19628906 
. 18872070 19262695. 19653320 
. 18896484 .19287109 —-. 19677734 
. 18920898 .19311523 —-.19702148 
18945313 . 19335938. 19726563 
18969727 .19360352 —.19750971 
18994141 19384766 19775391 
. 19018555 .19409180  .19799805 
. 19042969 19433594 ,19824219 
. 19067383 . 19458008 19848633 
19091797 19482422. 19873047 
19116211 . 19506836. 19897461 








.03 .04 
.01171875 .01562500 
.01196289 .01585914 
.01220703 -01611328 
01245117 .01635742 
-01269531 -01660156 
.01293945 .01684570 
.01318357 .01708984 
.01342773 .01733398 
-01367188 .01757813 
.01391602 -01782227 
.01416016 .01806641 
.0144043¢ .01831055 
-01464844 -01855469 
.01489258 .01879883 
.01513872 .01904297 
-01538086 .01928711 
maa 14 
.07421875 .078 12500 
.07446289 .078369 14 
.07470703 .07861328 
.07495117 .07885742 
.07519531 .07910156 
-07543945 .07934570 
.07568359 .07958984 
.07592773 .07983398 
.07617188 .080078 13 
.07641602 .08032227 
.07666016 .08056641 
-07690430 .0808 1055 
.07714844 -08 105469 
-07739 258 -08129883 
.07763672 .08 154297 
.07788086 -08178711 

23 24 
. 13671875 . 14062500 
. 13696289 . 14086914 
. 138720703 . 14741328 
. 13745117 . 14135742 
. 13769531 . 14160156 
. 13793945 . 14184570 
. 13818359 . 14208984 
. 13842773 . 14233398 
. 13867188 . 14257813 
. 13891602 . 14282227 
. 13916016 . 14306641 
. 13940430 . 14331055 
. 13964844 . 14355469 
. 13989258 . 14377883 
. 14013672 . 14404297 
. 14038086 - 1442871; 
.33 34 
. 19921875 . 20312500 
. 19946289 . 20336914 
. 19970703 . 20361328 
19995117 . 20385742 
. 20019531 . 20410156 
. 20043945 - 20434570 
. 20068359 . 20458984 
. 20092773 . 20482393 
. 20117188 . 20507813 
- 20141602 . 20532227 
. 20166016 «20556641 
. 20190430 . 2058 1055 
. 20214844 . 20605469 
. 20239258 . 20629883 
. 20263672 « 20654297 
. 20288086 . 20678711 


.05 
.01953125 
.01977539 
.02001953 
.02026367 
.0205078 1 
.02075195 
.02099609 
.02174023 
.02148438 
.02172852 
.02197266 
.02221680 
.02246094 
.02270508 
.02294922 
.02319336 

AS 
.08203125 
.08227539 
.08251953 
.08276367 
.0830078 1 
.08325195 
.08349609 
.083 74023 
.08398438 
.08422852 
.08447266 
.08471680 
.08496094 
-08520508 
.08544922 
.08569336 

25 
. 14453125 
. 14477539 
. 14501953 
. 14526367 
. 1455078 1 
. 14575195 


. 14599609 - 


. 14624023 
. 14648438 
. 14672852 
. 14697266 
. 14721680 
. 14746094 
. 14770508 
. 14794922 
14819336 
35 


",20703125. 


20727539 
. 20751953 
- 20776367 
. 2080078 1 
«20825195 
« 20849609 
. 20874023 
. 20898438 
« 20922852 
«26947266 
- 20971680 
« 20996094 
- 21020508 
21044922 
. 21069336 





06 


.02343750 
-02368 164 
-02392578 
.02416992 
-02441406 
-02465820 
.02490234 
.02514648 
-02539063 
.02563477 
-02587891 
.0261 2305 
-02636719 
.02661133 
-02685547 
.0270996 | 


16 


.08593750 
.08618164 
.08642578 
.08666992 
.0869 1406 
.08715820 
.08740234 
-08764648 
.08789063 
.088 13477 
.0883789 1 
-08862305 
.08886719 
.08911133 
.08935547 
.08959961 


26 


. 14843750 
. 14868164 
. 14892578 
. 14916992 
. 14941406 
- 14965829 
. 14990234 
- 15014648 
. 15039063 
. 15063477 
. 15087891 
. 15112305 
. 15136719 
. 15161133 
. 15185547 
. 15209961 


36 


. 21093750 
. 21118164 
- 21142578 
. 21166992 
. 21191406 
. 21215820 
. 21240234 
- 21264648 
. 21289063 
. 21313477 
- 21337891 
- 21362305 
. 21386719 
. 21411133 
. 21435547 
- 21459961 


.07 


.02734375 
.02758789 
.02783203 
.02807617 
-02832031 
-02856445 
.02880859 
.02905273 
.02929688 
.02954102 
-02978516 
.03002930 
.03027344 
.03051758 
.03076172 
.03 100586 


17 


.08984375 
.09008789 
-09033203 
.09057617 
.09082031 
.09106445 
.09130859 
.09155273 
.09179688 
.09204102 
-09228516 
.09252930 
.09277344 
.09301758 
.09326172 
.09350586 


27 


. 15234375 
. 15258789 
. 15283203 
«15307617 
. 15332031 
. 15356445 
- 15380859 
. 15405273 
. 15429688 
. 15454102 
. 15478516 
. 15502930 
. 15527344 
- 15551758 
. 15576172 
. 15600586 


137 


. 21484375 
. 21508789 
. 21533203 
. 21557617 
~ 21582031 
. 21606445 
. 21630859 
. 21655273 
. 21679688 
- 21704102 
. 21728518 
. 21752930 
. 21777344 
. 21801758 
» 21826172 
«21850586 


08 


.03125000 
.03149414 
.03173828 
-03198242 
-03222656 
.03247070 
.03271484 
.03295898 
-03320313 
.03344727 
-03369141 
.03393555 
-93417969 
.03442383 
.03456797 
.03491211 


18 


.09375000 
.09399414 
-094238 28 
.09448242 
.09472656 
.09497070 
.09521484 
-09545898 
.09570313 
.09594727 
.09619141 
-09643555 
.09667969 
.09692383 
.09716797 
.09741211 


28 


. 15625000 
. 15649414 
. 15673828 
. 15698242 
. 15722656 
. 15747070 
. 15771484 
. 15795898 
. 15820313 
. 15844727 
- 15869141 
. 15893555 
. 15917969 
. 15942383 
. 15966797 
15991211 


38 


. 21875000 
. 21899414 
21923828 
- 21948242 
«21972656 
«21997070 
«22021484 
. 22045898 
. 22070313 
«22094727 
. 22119141 
. 22143555 
. 22167969 
. 22192383 
. 22216797 
. 22241211 





. 10156250 : 


.0? 0A 
.03515625 .03906250 
.03340039 - 93930664 
.03564453 . 03955078 
. 03588867 .03979492 
.03613281 - 04003906 
.03637695 .04028320 
.03662109 .04052734 
.03686523 .04077148 
.03710938 04101563 
.03735352 04125977 
. 03759766 04150391 
.03784180 04174805 
.03808594 04199219 
.03832008 .04223633 
.03857422 04248047 
.0388 1836 .0427246 | 

iG LTA 
.09765625 
.09790039 . 10180664 
098 14453 . 10205078 
. 09838867 . 10229492 
-09863 28 1 . 10253906 
.09887695 . 10278320 
.09912109 . 10302734 
.09936523 . 10327148 
.09960938 . 10351563 
.09985352 . 10375977 
. 10009766 . 10400391 
. 10034180 . 10424805 
. 10058594 . 10449219 
. 10083008 . 10473633 
. 10107422 , 10498047 
. 10131836 . 10522461 

,29 .2A 
. 16015625 . 16406250 
. 16040039 . 16430664 
. 16064453 . 16455078 
. 16088867 . 18479492 
. 1611328) . 16503906 
. 16137695 . 16528320 
. 16162109 . 16552734 
. 16186523 . 16577148 
. 16210938 . 16601563 
. 16236352 . 16625977 
. 16259766 . 16650391 
. 16284180 . 16674805 
. 16308594 . 16699219 
. 16333008 . 16723633 
. 16357422 . 16748047 
. 16381836 . 16772461 

39 3A 
. 22265625 . 22656250 
. 22290039 . 22680664 
. 22314453 . 22705078 
. 22338867 22729492 
. 22363281 . 22753906 
. 22387695 . 22778320 
. 22412109 . 22802734 
. 22436523 . 22827148 
. 22460938 . 22851563 
. 22485352 . 22875977 
. 22509766 . 2290039 | 
. 22534180 . 22924805 
«22558594 . 22949219 
. 22583008 . 22973633 
. 22607422 . 22998047 
. 22631836 . 2302246 1 


Decimal to Hexadecimal Conversion Information (con’t) 











.0B .0C 
704296875 04687500 
04321289 .04711914 
.04345703 04736328 
04370117 04760742 
04394531 04785156 
04418945 04809570 
04443359 04833984 
04467773 04858398 
04492188 04882813 
04516602 04907227 
04541016 04931641 
04565430 04956055 
04589844 04980469 
04614258 95004883 
04638672 05029297 
04663086 05053711 
_1B IC 
10546875 10937500 
10571289 10961914 
. 10595703 . 10986328 
10620117 11010742 
10644531 11035156 
10668945 11059570 
. 10693359 11083984 
10717773 . 11108398 
. 10742188 11132813 
10766602 11157227 
10791016 1118164) 
. 10815430 11206055 
. 10839844 11230469 
. 10864258 11254883 
. 10888672 .11279297 
10913086 .11303711 
"28 ioe 
16796875 17187500 
. 1682} 289 17211914 
16845703 .17236328 
16870117 . 17260742 
16894531 . 17285156 
16918945 . 17309570 
. 16943359 . 17333984 
. 16967773 . 17358398 
. 16992188 . 17382813 
17016602 . 17407227 
17041016 17431641 
. 17065430 17456055 
. 17089844 17480469 
17114258 . 17504883 
. 17138672 .17529297 
17163086 17553711 
~ 3B Kal 
. 23046875 23437500 
. 23071289 23461914 
23095703 . 23486328 
23120117 23510742 
23144531 23535156 
. 23168945 . 23559570 
23193359 . 23583984 
. 23217773 . 23608398 
. 23242188 . 23632813 
. 23266602 . 23657227 
23291016 . 23681641 
. 23315430 . 23706055 
. 23339844 . 23730469 
. 23364258 . 23754883 
. 23388672 _ . 23779297 
. 23413086 . 23803711 


.OD 


"05078125 
.05102539 
05126953 
.05151367 
.05175781 
.05200195 
05224609 
05249023 
05273438 
05297852 
05322266 
05346680 
05371094 
05395508 
05419922 
05444336 
aol 
11328125 
. 11352539 
11376953 
. 11401367 
11425781 
11450195 
11474609 
11499023 
11523438 
. 11547852 
.11572266 
11596680 
11621094 
11645508 
11669922 
11694336 
2D 
17578125 
. 17602539 
17626953 
. 17651367 
. 17675781 
. 17700195 
17724609 
17749023 
. 17773438 
17797852 
. 17822266 
. 17846680 
17871094 
17895508 
17919922 
17944336 
) 


. 238 28125 
23852539 
. 23876953 
. 2390 1367 
. 23925781 
. 23950195 
. 2397 4609 
23999023 
. 24023438 
. 24047852 
«24072266 
. 24096680 
. 24121094 
. 24145508 
24169922 
. 24194336 


a nn eesti meena mn a neta 


.0E 


.05468750 
.05493164 
-05517578 
.05541992 
-05566406 
-055908 20 
-056 15234 
.05639648 
.05664063 
.05688477 
.05712891 
.05737305 
-05761719 
.05786 133 
.05810547 
05834961 


wlE 


. 11718750 
. 11743164 
. 11767578 
. 11791992 
. 11816406 
. 11840820 
. 11865234 
. 11889648 
. 11914063 
. 11938477 
11962891 
. 11987305 


12011719 
. 12036133 
. 12060547 
12084961 
.2E 
. 17968750 
. 17993164 
. 18017578 
. 18041992 
- 18066406 
. 18090820 
. 18115234 
. 18139648 
. 18164063 
. 18188477 
. 18212891 
. 18237305 
. 18261719 
- 18286133 
. 18310547 
. 18334961 


. 24218750 
«24243164 
. 24267578 
24291992 
. 24316406 
. 243408 20 
24365234 
- 24389648 
. 24414063 
. 24438477 
- 2446289 | 
. 24487305 
~ 24511719 
- 24536133 
. 24560547 
. 24584961 


Section 1: General Information 


OF 


.05859375 
.05883789 
.05908203 
-05932617 
.05957031 
.05981445 
.06005859 
.06030273 
.06054688 
.06079102 
.06 103516 
.06 127930 
.06152344 
.06176758 
-06201172 
.06225586 
JF 
. 12109375 
. 12133789 
. 12158203 
. 12182617 
12207031 
. 12231445 
. 12255859 
. 12280273 
. 12304688 
. 12329102 
. 12353516 


. 12377930 | 


. 12402344 
« 12426758 


~ 12451172 | 


-1 2475586 
-2F 
. 18359375 
. 18383789 
. 18408203 
. 18432617 
. 1845703] 
. 18481445 
. 18505859 
. 18530273 
. 18554688 
. 18579102 
. 18603516 
. 18627930 
. 18652344 
. 18676758 


. 18701172 | 


18725586 _ 


. 24609375 
24633789 
. 24658203 
- 24682617 
. 24707031 
. 24731445 
24755859 
. 24780273 
. 24804688 
- 24829102 
. 24853516 
. 24877930 
- 24902344 
. 24926758 
. 24951172 
. 24975586 


1-59 


Decimal to Hexadecimal Conversion Information (con’t) 








. OOF 


-000 
001 

.002 
.003 
.004 
.005 
.006 
007 
.008 
.009 
.00A 
-00B 

.00C 
-00D 
.QOE 

OOF 


000 
-001 
-002 
-003 
.004 
-005 
-006 
.007 
-008 
.009 
-00A 
.008 
.00C 
-00D 
-O0E 
, OOF 


1-60 



































. 27343750 
. 27368 164 
. 27392578 
. 27416992 
. 27441406 
« 274658 20 
. 27490234 
. 27514648 
. 27539063 
. 27563477 
. 2758789 | 
. 27612305 
. 27636719 
. 27661133 
. 27685547 
. 2770996 | 








40 4] 42 43 44 45 
25000000 25390625 25781250 26171875 . 26562500 . 26953125 
25024414 25415039 . 25805664 26196289 . 265869 14 26977539 
. 25048828 25439453 . 25830078 . 26220703 . 26611328 . 27001953 
25073242 25463867 . 25854492 26245117 26635742 . 27026367 
25097656 2548828 1 . 25878906 26269531 . 26660156 . 27050781 
25122070 25512695 . 25903320 26293945 . 26684570 27075195 
25146484 25537109 25927734 26318359 . 26708984 27099609 
25170898 25561523 25952148 . 26342773 . 26733398 . 27124023 
. 25195313 . 25585938 . 25976563 . 26367188 26757813 27148438 
25219727 256 10352 . 26000977 2639 1602 26782227 27172852 
25244141 25634766 . 26025391 26416016 . 26806641 . 27197266 
25268555 25659180 . 26049805 . 26440430 . 26831055 . 27221680 
25292969 25683594 . 26074219 26464844 . 26855469 . 27246094 
25317383 .25708008 =‘. 26098633 . 26489258 , 26879883 . 27270508 
25341797 25732422 26123047 26513672 . 26904297 27294922 
25366211 . 25756836 26147461 . 26538086 26928711 . 27319336 

50 51 i) Fi) ny. 55 
31250000 31640625 32031250 32421875 .32812500  -. 33203125 
31274414 31665039 32055664 32446289 32836914 33227539 
31298828 31689453 32080078 32470703 32861328 33251953 
31323242 31713867 32104492 32495117 32885742 33276367 
31347656 31738281 32128906 32519531 32910156 3330078 | 
.31372070 31762695 .32153320 32543945 32934570 33325195 
31396484 31787109 32177734 32568359 32958984 33349609 
31420898 31811523 32202148 32592773 32983393 33374023 
.31445313 31835938 32226563 32617188 . 33007812 33398438 
31469727 .31860352 32250977 32641602 '3303.2227 33422852 
.3149414] 31884766 3227539 | 32666016 33056641 33447266 
.31518555 31909180 32299805 32690430 33081055 33471680 
31542969 31933594 32324219 32714844 33105469 33496094 
31567383 .31958008 32348633 32739258 33129883 33520508 
31591797 31982422 32373047 32763672 33154297 33544922 
31616211 32006836 3239746 | 32788086 33178711 33569336 

60 61 62 63 64 65 
37500000 37890625 3828 1250 38671875 39062500 39453125 
37524414 37915039 38305664 38696289 390869 14 39477539 
37548828 37939453 38330078 38720703 39111328 39501953 
37573242 37963867 38354492 38745117 39135742 39526367 
37597656 37988281 38378906 38769531 .39160156 3955078 1 
37622070 38012695 38403320 38793945 39184570 39575195 
37646484 38037109 38427734 388 18359 39208984 39599609 
37670898 38061523 38452148 38842773 39233398 39624023 
37695313 38085938 38476563 38867188 39257813 39648438 
.37719727 38110352 38500977 38891602 39282227 39672852 
3774414) 38134766 38525391 38916016 39306641 39697266 
37768555 38159180 38549805 38940430 39331055 39721680 
37792969 38183594 38574219 38964844 39355469 39746094 
37817383 38208008 38598633 38989258 39379883 39770508 
.37841797 38232422 38623047 39013672 39404297 39794922 
37866211 38256836 3864746 | 39038086 39428711 39819336 

.70 7] 72 ty 74 REE 

| .43750000 44140625 44531250 44921875 45312500 45703125 
.43774414 44165039 44555664 44946289 453369 14 45727539 
43798828 .44189453 . 44580078 .44970703 . 4536 1328 45751953 
43823242 .44213867 44604492 .44995117 45385742 45776367 
43847656 44238281 446 28906 45019531 45410156 4580078 1 
43872070 44262695 446533 20 45043945 45434570 45825195 
43896484 . 44287109 .44677734 45068359 .45458984 45849609 
43920898 44311523 44702148 45092773 . 45483398 45874023 
43945313 . 44335938 44726563 45117188 .455078 13 45898438 
43969727 44360352 .44750977 45141602 45532227 45922852 
43994141 44384766 4477539 .45166016 4555664) 45947 266 
.44018555 .44409180 44799805 .45190430 . 45581055 45971680 
-44042969 -44433594 .44824219 45214844 45605469 45996094 
44067383 44458008 44848633 45239258 . 45629883 46020508 
44091797 44482422 . 44873047 45263672 45654297 46044922 
.44116211 44506836 4489746 | 45288086 4567871) 46069336 





OS/VS Programmer’s Reference Digest 


46 














36 


.33593750 
.336 18164 
. 33642578 
33666992 
. 3369 1 406 
. 33715820 
. 33740234 
. 33764648 
.33789063 
.338 13477 
. 3383789 | 
. 33862305 
. 33886719 
.33913133 
. 33935547 
233959961 


.66 


. 39843750 
. 39868 164 
. 39892578 
399 16992 
. 39941406 
. 39965820 
39990234 
. 40014648 
. 40039063 
. 40063477 
. 4008789 | 
.401 12305 
.40136719 
-40161133 
-40185547 
.40209961 


-76 


- 46093750 
46118164 
. 46142578 
.46166992 
-46191406 
- 46215820 
-46240234 
. 46264648 
- 46289063 
.46313477 
. 4633789 | 
. 46362305 
- 46386719 
. 46411133 
. 46435547 
- 46459961 














4E 

















47 . 48 49 4A 4B 40 .4D 
. 27734375 . 28125000 . 28515625 . 289046250 . 29296875 - 29687500 . 30078125 
. 27758789 . 28149414 . 28540039 . 28930664 . 29321289 - 29711914 , 30102529 
. 27783203 . 28173828 . 28564453 . 28955078 . 29345703 - 29736328 . 30126953 
. 27807617 . 28198242 . 28588867 . 28979492 . 29370117 - 29760742 . 30151367 
, 27832031 «28222656 . 28613281 . 29003906 29394531 «29785156 . 30175781 
. 27856445 . 28247070 . 28637695 , 29028320 ~ 29418945 - 29809570 . 30200195 
. 27880859 . 28271484 . 28662109 . 29052734 . 29443357 «29833984 . 30224609 
. 27905273 - 28295898 . 28686523 . 29077148 . 29467773 - 29858398 . 30249023 
. 27929688 . 28320313 . 28710938 . 29101563 . 29492188 . 2988 28 13 . 30273438 
27954102 . 28344727 . 28735352 «29125977 - 29516602 . 29907227 . 30297852 
. 27978516 . 28369141 . 28759766 . 29150390 . 29541016 - 29931641 . 30322266 
. 28002930 . 28393555 . 28784180 - 29174805 » 29565430 - 29956055 . 30346680 
. 28027344 . 28417969 . 28808594 . 29199219 . 29589844 «29980469 . 30371094 
. 28051758 . 28442383 . 28833008 . 29223633 . 29614258 . 30004883 . 30395508 
. 28076172 . 28466797 . 28857422 . 29248047 - 29638672 » 30029297 . 30419922 
. 28100586 . 28491211 . 2888 1836 . 2927246 | . 29663086 . 30053711 . 30444336 
57 .58 59 5A . 5B 2G .5D 
. 33984375 . 34375000 34765625 - 35156250 - 35546875 . 35937500 . 36328125 
. 34008789 . 34399414 . 34790039 . 35180664 . 35571289 .3596 1914 . 36352539 
. 34033203 . 344238 28 . 34814453 - 35205078 . 35595703 - 35986328 . 36376953 
. 34057617 34448 242 . 34838867 . 35229492 . 35620117 - 36010742 . 36401367 
. 34082031 34472656 . 34863 28 | . 35253906 35644531 . 36035156 . 3642578 1 
. 34106445 . 34497070 - 34887695 . 35278320 - 35668945 . 36059570 . 36450195 
. 34130859 .34521484 34912109 . 35302734 . 35693359 . 36083984 . 36474609 
.34155273 . 34545898 . 34936523 . 35327148 . 35717773 . 36108398 - 36499023 
. 34179688 - 34570313 . 34960938 . 35351563 , 35742183 - 36132813 . 36523438 
. 34204102 . 34594727 34985352 .35375977 . 35766602 36157227 - 36547852 
~ 34228516 -34619141 . 35009766 . 3540039 1 35791018 . 36181641 . 36572266 
- 34252930 34643555 . 35034180 . 35424805 . 35815430 - 36206055 - 35596680 
. 34277344 - 34667969 . 35058594 35449219 . 35839844 36230469 36621094 
. 34301758 . 34692383 . 35083008 . 35473633 . 35864258 . 36254883 36645508 
, 34326172 .347 16797 . 35107422 . 35498047 . 35888672 - 36279297 - 36669922 
. 34350586 .34741211 . 35131836 . 3552246] . 35913084 . 36303711 . 36694336 
.67 .68 .69 6A . 6B .6C .6D 
. 40234375 , 40625000 . 41015625 . 41406250 41796875 . 42187500 .42578125 
40258789 40649414 . 41040039 . 41430664 .41821 289 42211914 » 42602539 
. 40283203 . 406738 28 . 41064453 - 41455078 . 41845703 . 42236328 42626953 
.403076 17 - 40698242 41988867 .41479492 41870117 . 42260742 - 42651367 
. 4033203 1 . 40722656 .41113281 - 41503906 41894531 . 42285156 .4267578 1 
40356445 - 40747070 -41137695 - 41528320 ~ 41918945 .42309570 .42700 195 
. 403808 5° .4077 1484 -41162109 -41552734 41943359 - 42333984 - 42724609 
40405273 40795898 . 41186523 41577148 .41967773 - 42358398 42749023 
. 40429688 . 40820313 . 41210938 . 41601563 , 41992188 . 42382813 . 42773438 
40454102 . 40844727 41235352 41625977 42016602 42407227 .42797852 
. 40478516 . 40869141 . 41259766 -41650391 «42041016 -4243164]1 .42822266 
- 40502930 . 40893555 41284180 41674805 . 42065430 . 42456055 . 42846680 
. 40527344 40917969 -41308594 41699219 . 42089844 42480469 . 42871094 
40551758 . 40942383 - 41333008 .41723633 -42114258 - 42504883 . 42895508 
40576172 - 40966797 .41357422 -41 748047 , 42138672 »42529297 42919922 
. 40600586 .4099121] . 41381836 41772461 421563086 .42553711 . 42944336 
77 .78 79 7A . 7B we 7D 
- 46484375 . 46875000 - 47265625 - 47656250 48046575 - 48437500 . 48828125 
- 46508789 .46899414 . 47290039 - 47680664 - 48071289 48461914 - 48852539 
- 46533203 - 469238 28 47314453 . 47705078 . 48095703 -48486328 . 48876953 
465576 17 - 46948 242 . 47338867 . 47729492 -48120117 - 48510742 - 48901367 
- 4658 203] 46972656 . 4736328 | - 47753906 4814453) - 48535156 - 48925781 
. 46606445 .46997070 . 47387695 - 47778320 - 48168945 - 48559570 - 48950195 
- 46630859 - 47021484 47412109 - 47802734 48193359 48583984 48974609 
. 46655273 47045898 47436523 . 478271 48 -48217775 . 48608398 - 489990 23 
. 46679588 -47070313 . 47460938 - 47851563 - 48242188 . 486328 13 - 49023438 
46704192 - 47094727 .47485352 . 47875977 - 48266602 48657227 - 49047852 
46728516 -47119141 . 47509766 . 4790039 1 48291016 - 48681641 - 49072266 
. 46752930 - 47143555 - 47534180 . 47924805 . 48315430 . 48706055 - 49094680 
46777344 47167969 .47558594 47949219 - 48339844 . 48730469 -49121094 
. 46801758 - 47192383 . 47583008 47973633 - 48364258 . 48754883 - 49145508 
- 46826172 .47216797 -47607422 . 47998047 . 48388672 48779297 49169922 
. 46850586 -47241211 . 47631836 . 4802246 | - 48413086 . 4880371] - 49194336 


. 30468750 
- 30493164 
.30517578 
30541992 
. 30566406 
- 30590820 
. 30615234 
. 30639648 
- 30664063 
. 30688477 
. 30712891 
. 30737305 
30761719 
. 30786133 
.308 10547 
30834961 


JE 


. 36718750 
. 36743164 
. 36767578 
36791992 
. 36816406 
- 36840820 
. 36865234 
. 36889648 
. 36914063 
. 36938477 
. 3696 289 | 
- 36987305 
.37011719 
. 37036 133 
-37060547 
. 37084961 


GE 


-42968750 
-42993164 
- 43017578 
- 43041992 
- 43066406 
- 43090820 
- 43115234 
- 43139648 
- 43164063 
. 43188477 
43212891 
- 43237305 
-43261719 
- 43286133 
- 43310547 
.4333496 1 


7E 


-49218750 
- 49243164 
- 49267578 
-4929 1992 
- 49316406 
- 49340820 
- 49365234 
- 49389648 
- 49414063 
- 49438477 
- 49462891 
49487305 
49511719 
- 49536 133 
. 49560547 
- 49584961 



















30859375 
30883789 
30908203 
30932617 
.30957031 
30981445 
31005859 
31030273 
31054688 
31079102 
.31103516 
31127930 
31152344 
31176758 
31201172 
31225586 
oF 
37109375 
37133789 
.37158203 
37182617 
37207031 
37231445 
37255859 
37280273 
37304688 
37329102 
37353516 
37377930 
37402344 
37426758 
37451172 
37475586 
OF 
43359375 
43383789 
. 43408203 
43432617 
43457031 
43481445 
43505859 
43530273 
42554688 
43579102 
43603516 
43627930 
43652344 
43676758 
43701172 
43725586 
Save 
49609375 
49633789 
49658203 
49682617 
49707031 
49731445 
49755859 
49780273 
49804688 
49829102 
49853516 
49877930 
49902344 
. 49926758 
49951172 
49975586 
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Save Area Format 2-2 
Linkage Register Conventions 2-3 
UCB Sense Information 2-4 
Completion Codes 

for VSI 2-12 

for VS2. 2-21 








Source Publications 


Additional information about linkage registers is in Supervisor 
Services and Macros, GC27-6979. 


You can obtain additional information about the devices referenced 
from the publication on the theory of operations or operating pro- 
cedures. Refer to the JBM System/360 and System/370 Bibliography. 
GA22-6822 for a list of these publications. 





You can obtain additional information about completion codes from 
OS/VS Message Library: VS1 System Codes, GC38-1003 or OS/V'S 
Message Library: VS2 System Codes, GC38-1008. 
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Save Area Format 


Used by PL/1 language-compiled program 


Address of previous save area (stored by called program) 
Address of next save area (stored by calling program) 
Register 14 (return address) 

Register 15 (entry-point address) 

Register 0 

Register 1 

Register 2 

Register 3 

Register 4 

Register 5 

Register 6 

Register 7 

Register 8 

Register 9 

Register 10 

Register 11 


Register 12 
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Linkage Register Conventions 


Linkage 


Register Conventions 
Use 


Passes parameters to the control program or the called program. 
Parameter type depends on macro type. 


Passes parameters or the address of a parameter list to the control 
program, or passes parameters to the called program. Parameter 
type depends on macro type. 


Work registers: not changed by the control program. 


Passes the address of the register save area provided by the 
calling program. 


Passes the return address to the calling program or the control 
program. 


Contains the entry-point address, the address of a parameter list 
as the result of using certain macros, or the return code. 
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UCB Sense Information 


poms * Tt 
various mare 


BYTE 0 






CMD INT BUS 
REJ REQ OUT Gi 


HK 
1287 CMD {NT BUS EQ DATA OVER- | NON KYBD 
RES REQ OUT CHK CHK RUN RCVY CORR 
ee ie INT BUS EQ DATA OVER- | NON 
ie REQ OUT CHK CHK RUN RCVY 


CMD INT BUS EQ 

REJ REQ OUT CHK 
TYPE 
BAR 


Eg 2501, ca ee | a ee ee OVER- 
Eg 25% ca ee | a ee Eee RUN 


1419/1275 CMD INT BUS DATA OVER- | AUTO 
PCU RES REQ OUT CHK RUN SELECT 
oe CMD INT BUS OUT DATA OVER- | AUTO 
oe REJ REQ CHK CHK RUN SELECT 
CMD INT BUS EQ DATA OVER- | BUFFER 
REJ REQ OUT CHK CHK RUN RUN- 
NING 


CMD INT BUS 
REJ REQ OUT ca 


K 
2305 CMD INT BUS EQ DATA OVER- 
REJ REQ OUT CHK CHK RUN 
2314, 2319 CMD INT BUS EQ DATA OVER- 
REJ REQ OUT CHK CHK RUN 
CHK 
CMD INT BUS EQ DATA OVER- | WRD 
REJ REQ OUT CHK CHK RUN CNT 
ZERO 
2495 CMD INT BUS EQ DATA SHOULD | POSN 
REJ REQ OUT CHK CHK NOT CHK 
OCCUR 
CMD INT BUS EQ DATA 
REJ REQ OUT CHK CHK 
fea hae 2822. | CMD INT BUS EQ DATA 
fea hae REQ OUT CHK CHK 


3210, 3215 | CMD Ee 
REJ Ee ee 


K 
3211 CMD INT BUS EQ DATA BUFFER | LOAD CH? 
REJ REQ OUT CHK CHK PARITY | CHK 
CHK 
3330, 3333 CMD INT BUS EQ DATA OVER- 
REJ REQ OUT CHK CHK RUN 
3410, 3411 INT BUS EQ DATA OVER- | WRD 
REQ OUT CHK CHK RUN 
3420, 3803 INT BUS EQ DATA OVER- 
REQ OuT CHK CHK RUN 


INT BUS EQ DATA 
REQ OUT CHK CHK 
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COUNT | CNVT 





3505, 3525 






FORMAT | ERR 
























UCB Sense Information (con’t) 


_ aa 
3505, 3525 | PERM 
ERR 


LATE 
STKR 
SELECT 


END 
OF 
PAGE 


FLD 7 
VALID 


END 
ORDER 
SEQ 


DOC 
UNDER 
W HD 


AMT 
FLD 
VALID 


CHAR 
MODE 


FOUND 


00- NON-XST TU 
O1-NOT READY 


INVAL 
SEQ 
10-RDY & NO RWD 


7 TRK 
H1-RDY & RWDING 
PRINT = | PRINT LINE 
CHK QUALITY | POS 


INVLO j END STATE 
TRK OF VAR 
FORMAT] CYL PRES 


TU 

STAT 

B 

TU 7 TRK 
STAT 

B 


MOTION] RETRY 

MAL AFTER 
INT REQ 
COMP 


NO 
REC 
FOUND 


TU 
STAT 
A 


AT 
LOAD 
POINT 


TU 
STAT 
A 


AT 
LOAD 
POINT 


AUTO 
RETRY 
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TRANSIT] SER# 


SERVICE 
OVER- 
RUN 


FILE 
PROT 


WRT 
STATUS 
FILE WRITE 
PROT INHIBIT 


WRT FILE 
STAT PROT 
WRT FILE 
STAT PROT 
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UCB Sense Information (con’‘t) 


Senne 


BUFFER ADDRESS REGISTER 
BIT 15 BIT 14 BIT 13 BIT 12 BIT 11 BIT 10 BIT 9 


BUFFER ADDRESS REGISTER 
BIT 15 BIT 14 BIT 13 BIT 12 BIT 11 BIT 10 BIT? 


BUF COR- 
LOG RECT- 
ABLE 


















6 & 7 INDICATE 
NO ERROR OR 
MULTI-ERROR 





COR- 
RECT 
ABLE 
3410, 3411 TRACK IN ERROR BITS 
3420, 3803 TRACK IN ERROR BITS 


} 3505, 3525 | 3525 | USED FOR DIAGNOSTIC PURPOSES ONLY FOR DIAGNOSTIC PURPOSES ONLY 








BYTE 3 
2250, 228 BUFFER ADDRESS REGISTER 





BIT 8 BIT 7 BIT 6 BIT 5 BIT 4 BIT 3 BIT 2 BIT 1 


ue 










RESTART COMMAND 
_ BUSY ON UNSAFE PACK END M-MODE| SEEK 
LINE CUR CHNG | OF SE INC 
CFN CYL 
ca ca ie. LRC 
ca 0 ca 1 ie. 2 BIT 3 





= LRCR SKEW SKEW 0-1600 | BKWD | COM- 
ie REQ 1~800 STATUS | PARE 
mie PLB FCB COIL HAM-~ FIELD USCAR | SEP 
PARITY | PARITY | PARITY | PROT MER ENG SYNC SYNC 
CHK FIRE CHK CHK 
RESTART COMMAND 
MTE/ SKEW ENV 1600 BKWD 
vA LRCR CHK BPI 
IN TU 
3420, 3803 | R/W MTE/ SKEW VRC/ 1600 BKWD COM- 
VRC LRC ENV BPI PARE 
CHK/CRC| CHK 


} 3505, 3525 3525 USED FOR DIAGNOSTIC PURPOSES ONLY 
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2250, 2260 


2305 
2314 PHY SICAL 
ORIVE ID 
2319 SEQ SEQ SEQ SEQ SEQ SEQ SEQ SEQ 
INDO IND 1 IND 2 IND 3 IND 4 IND 5 IND 6 IND 7 





ECHO RES READ DELAY | SEQ SEQ SEQ 
2400 ERR TAPE | CLOCK | CLOCK | cNTR {| INDC | INDB | INDA 
UNIT | ERR 
3330, 3333 PHYSICAL DRIVE IDENTIFICATION 


TU REJ 
3410, 3411 POSIT TAPE EOT SPARE 
CHK UNIT 
ALU REJ TAPE RES 
3420, 3803 | HDWR TAPE INOI- RPQ 
ERROR UNIT CATE 


2305 CYLINDER ADDRESS 


| 2a COMMAND IN PROGRESS WHEN OVERFLOW INCOMPLETE OCCURS 


} 200 | COMMAND IN PROGRESS WHEN OVERFLOW INCOMPLETE OCCURS 
OR ZERO 























3211 





3930, 3333 CYLINDER ADDRESS 


NEW NEW WRT PE ID PRTY TACH FALSE 
3410, 3411 | SUB- SUB- ™ BURST come | CHK END 
SYSTEM | SYSTEM CHK MARK 


NEW NEW wet START XCESSVE 
PE 1D PARTIAL RES 
3420, 3803 | SUB- SUB- ™M BURST READ RECORD PSTAMBL 











SYSTEM | SYSTEM CHK CHK ORTM 


CURRENT HEAD ADDRESS 








HIGH HIGH 


SHRT | DUAL ALT 


3420, 3803 7 TRK NRZt TAPE UNIT MODEL DEFINED 
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3330, 3333 | reverse} CYL | OIFFER HEAD ADDRESS 








UCB Sense Information (con't) eee 


on 


ENCODED ERROR MESSAGE 


FORMAT OF REMAINING ENCODED ERROR MESSAGE 
SENSE BYTES (8~ 23) 


3410, 3411 LAMP LEFT RT RESET DATA 
CHK cOL COL KEY SEC 
CHK CHK ERASE 


3420, 3803. | LAMP RESET ERASE AIR LOAD 
FAIL BOTTOM | BOTTOM | KEY HEAD BRNG FAIL 
FAILED | PRESS 





BYTE 8 











3410, 3411 WRT END START MAR~ 
FEED 
THRU 
CHK 
3420, 3803 | IRG FEED SOR 
DROP THRU CNTR 
IN WRT | CHK 














BGN RD} END RD 
BK CHK | BK CHK 


BGN RD| END RD 
BK CHK | BK CHK 


TAPE 
CTL 
RESD 








BYTE 10 
oe 3803 | CMD NO BLK | WTM VELO- 















STATUS 
REJ 


STATUS | ON RCD | NOT 
RD BKCK| DETECT | FAIL 


BYTE 11 


SG 


3420, 3803 | B BUS 
PARITY 
ALU 1 
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" 5 7 — 
DEVICE ~ 








UCB Sense Information (con‘t) 
Byte 12 














CONTROL 
UNIT 
DENSITY 


CONTROL UNIT UNIQUE 
ID - HIGH ORDER 


CONTROL UNIT UNIQUE 
iD - LOW ORDER 


TAPE UNIT UNIQUE ID - 
HIGH ORDER 
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fr 


UCB Sense Information (con’t) 
Byte 16 


TAPE UNIT UNIQUE ID - 
LOW ORDER 


CONTROL UNIT 
WITH DEVICE 
SWITCH FEATURES 


PRIMED FOR DEVICE END 
TUS TUS TU 4 
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EC LEVEL OF 
TAPE CONTROL UNIT 


EC LEVEL OF 
TAPE UNIT 


TU 3 




















UCB Sense Information (con't) 








Byte 20 
BIT 
DEVICE 4 7 
3420, PRIMED FOR DEVICE END 
3803 TU F TUE Tu D TUC TU B TUA Tu? | Tus 


Byte 21 


LEFT RIGHT TAPE REELS LOAD LOAD i 
BUTTON REEL REEL PRESENT | LOADED | REWIND} COM- | CHK 
DEPRESS | TRNG TRNG PLETE 








3420, FRU IDENTIFIERS FOR ALU 1 
3803 


Byte 22 
BIT 
DEVICE 4 7 





Byte 23 
BIT 
DEVICE 4 7 
3420, FRU IDENTIFIERS FOR ALU 2 
3803 
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OS/VS1 Completion Code Summary 


G Completion| Operation or Explonati 
FOUP | Code Macro Instruction : a de 


BISAM/ CHECK, GET, PUT] 1/O error; terminate specified or no 
BSAM/ SYNAD specified. 
QSAM/ 

















Record is greater than 32,768 bytes, exceeds 
maximum track length or stated block size; 

block could not be contained in one extent; 
too many tracks specified for cylinder over- 
flow; BDW or RDW (SDW) invalid; record to 
be transferred larger than track capacity. 











3525 associated data set 1/O sequence error. 
















Invalid FORMAT card or invalid device 
specified with OMR; conflicting or invalid 
DCB parameter; data protection image not 
found in SYST.IMAGELIB. 


08 CHECK while SYNAD returned to CHECK routine, but save 
creating data set | area was destroyed, 


0 
020 Invalid DCBMACRF field. 


OPEN for 3525/ 
3505 














BSAM 














025 Address in DCBSQND field outside task, 













026 Invalid DCBXARG field or exclusive control 


status not indicated. 


Processing with 
exclusive control 










BISAM/ Invalid DCBMACRF field. 


QISAM 






Invalid DCBMACRF field. 







I/O error in reading highest level index or 
while reading the last prime data block or 
in validating last record pointers; address in 

DCBMSHI field outside task or under incorrect 
protection key. 










No prime area specified. 






User supplied buffers to small. 






I/O error writing updated format 2 DSCB. 







DCBSMSI field specifies area too small for 
highest level index; invalid address in 
DCBMSWA, 










DCBSMSW and DCBMSWA fields specify area 


too small for one track. 






QISAM I/O error; no SYNAD specified. 






OPEN 


Index area too small or crosses volumes. 








End of data set; no exit routine address in 
DCBECDAD field. 


Seanning 






OPEN ISAM data set to be processed, but not crea- 
ted or its DCB not closed after creation; 
invalid DCBRKP field; DCBKEYLE field was 
zero; OPEN macro not issued for output; 


BLKSIZE or LRECL specified incorrectly. 









No space available for resume loading. 
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OS/VS1 Completion Code Summary (con’t) 


Completion| Operation or : 
Grou Explanation 
| Grove [eete Macro Instruction v. 


03D OPEN Missing format 2 DSCB, or serial numbers for 
SER in DD not in order or not all present. 




















OPEN Error in opening a TCAM line group data set. 


OPEN 





Error in opening a TCAM message queues 
data set. 





Error in running a TCAM MCP with the 
telecommunication on-line test executive. 


Processing 





OPEN 





Error in opening a TCAM application program 
date set. 


Processing 






Error in processing the FE Common Write 
subtask. 
Message Control I/O error or logical read error. 
Program (MCP) 















CLOSE TCAM MCP is scheduled to be terminated, 
application program data set is active. 
Completion code is for the application 


program data set. 













Graphics attention 
service routine 


Graphics 
access 
method 


ANALYZ or GSERV specified DCB, which 
pointed to DEB, which pointed to invalid 
UCB. 










(GAM) 


Graphics attention 
service routine 


ANALYZ or GSERV specified DCB, which 
pointed to DEB, which pointed to UCB for 
other than graphics device. 













CLOSE CLOSE issued DAR for GACB that was not 


specified (via SPAR) for the closing task. 











Graphics Subroutine 
Package (GSP) for 
FORTRAN IV, 

COBOL, and PL/I 


Return code equal to or greater than absolute 
value of null argument produced. 











2250 operator pressed alphameric keyboard 
CANCEL key and selected DUMP or 
TERMINATE option to terminate program. 


UCB for other than communications device. 








UCB specified invalid or unsupported 
transmission control unit. 







UCB specified invalid or unsupported terminal 
control or adapter. 


UCB specified invalid or unsupported terminal 





UCB specified invalid or unsupported optional 
feature or mode of operation. 












Line group did not have identical terminal 
types and/or optional features. 





DCBBFTEK field specified dynamic buffer 
allocation, but DCBBUFCB, DCBBUFNO, and 
DCBBUFL fields not specified. 


Section 2: OS/VS System Information 2-13 





OS/VS1 Completion Code Summary (con't) 


G Completion! Operation or Excslanati 
FouP  |Code Macro Instruction Menaees 


BTAM 097 OPEN Device I/O directory full. 
(cont'd) 
098 OPEN 
Job OBO 
sched - 
uler 
1BO 


EXCP 
(SVC 00) 
200 
300 
400 
500 |/O Operation 


WAIT 101 WAIT 
(SVC 01) 
201 WAIT 
301 WAIT 


POST 102 POST 
(SVC 02) 
202 POST 


Task RETURN or branch 
termin= to return address in 
ation register 14 

(SVC 03) 

















Transmission control unit not a 2701 or the 
Dual Communication Interface, or Dual Code 
Feature not specified in UCB. 











I/O error in reading or writing” 
SYS1.SYSJOBQE or SWADS. 









Invalid TTR for SYS1.SYSJOBQE found by 
system conversion routine. 










Program interruption, not in I/O interruption 
handler or type 1 SVC routine; no program 
routine to handle interruption; x=program 
interruption code. 










Program interrupt in I/O interrupt handler. 








Program interrupt in type 1 SVC routine. 





Machine-~ check interrupt; MCH able to 
abnormally terminate job step and continue 
operating system. 








Program interrupt occurred while loading 
transient area for type 3 or 4 SVC. 






1/O Operation 


Device not operational. 






|/O Operation 





Invalid ECB, 1OB, DCB protect key. 








1/O Operation Invalid DEB protect key; not enough extents 


in DEB. 











1/O Operation Invalid DCB pointers. 






Invalid UCB address. 






More events than ECBs. 






Invalid ECB address. 









ECB wait flag already on. 






Invalid ECB address. 





Invalid RB address in ECB. 
















ECB already posted or RB address in ECB 
invalid. 















RETURN or branch 
to return address in 
register 14 


Subtasks not yet terminated. 




















RETURN or branch 
to return address in 
register 14. 


TCBDEB points to DEB that is associated with 
an invalid DCB. WARNING: All data sets 
not closed. 









RETURN or branch 
to return address in 
register 14. 


ENQ resources not released yet. 
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OS/VS1 Completion Code Summary (con't) 


Completion| Operation or 
7 Exp! 
Macro Instruction xplanation 

604 


GETMAIN GETMAIN Address in A or LA operand is outside task; 
(SVC 04) address of parameter list invalid. 























704 GETMAIN List request; not VS2 system. 








804 





GETMAIN 


Request for zero bytes of virtual storage or 
not enough virtual storage available. 








B04 GETMAIN Subpool number greater than 127, 

















GETMAIN from 
program in super- 
visor mode 


Not enough SQA available. 





FREEMAIN Address in A or LA operand is outside task; 


address of parameter list invalid. 





FREEMAIN List request; not VS2 system. 


FREEMAIN 





Address of area to be freed not multiple of 8. 





FREEMAIN Area to be freed overlaps existing free area. 


FREEMAIN 





Subpool number greater than 127, 

















Contents 
supervi = 
sor 
(SVC 06) 


LINK, LOAD, 
ATTACH, XCTL 


Error while loading module into virtual 
storage; invalid record type, invalid address, 
1/O error. 



















LINK, ATTACH, 
XCTL 


Module was only loadable; module specified 
by entry point defined by IDENTIFY macro. 











506 LINK, LOAD, 
ATTACH, XCTL 


Not enough virtual storage for module and 
overlay supervisor. 










606 LINK, LOAD, 
ATTACH, XCTL 


Not enough virtual storage for module. 










706 LINK, LOAD, 
ATTACH, XCTL 


Module marked "NOT EXECUTABLE." 






BLDL detected error; module not found or I/O 
error during directory search. 


806 LINK, LOAD, 
ATTACH, XCTL 











906 LINK More than 255 tasks waiting for reentrable or 


serially reusable module. 










A06 LINK, LOAD, 
ATTACH, XCTL 


Task already waiting for serially reusable 
module. 











B06 1/O activity Abnormally terminating system error task 


reinstated; user task abnormally terminated. 











C06 





Abnormally terminating transient area task 
reinstated; user task abnormally terminated. 


XCTL 207 XCTL Asynchronous exit routine attempted to 

(SVC 07) execute XCTL. 

LOAD 308 LOAD Module specified by entry point defined by 
IDENTIFY macro, 


(SVC 08) 
Section 2: OS/VS System Information 2-15 











OS/VS1 Completion Code Summary (con't) 


Completion} Operation or 
Grou P Explanation 
Code Macro Instruction P 


FREEMAIN Invalid specification of an area to be freed; 
address of area to be freed (in register 1) not 
multiple of 8. 

















GETMAIN 





Request for zero bytes of virtual storage or 
not enough virtual storage available. 


FREEMAIN 





Address of area to be freed not a multiple 
of 8, 


FREEMAIN 





Area to be freed overlaps an existing free 
area. 








GETMAIN, 
FREEMAIN 


Subpool number greater than 127. 









Invalid ABEND recursion during abnormal 
termination of subtask; job step task 
terminated . 















Insufficient virtual storage available for 
ABEND processing of subtask, job step 
terminated. 


Conflicting or unsupported parameters in 
DCB; member name specified in DD not 

not found; no directory allocation subparam- 
eter in DD. 


























OPEN, OPEN 
with TYPE=J 


I/O error in reading or writing JFCB or in 
reading JFCB extension block; no exit code 
provided. 


OPEN 





DSCB not found; 1/O error in reading or 
writing DSCB; unable to locate PASSWORD 
data set. 


I/O error in reading format 2 or 3 DSCB. 


INPUT specified but no serial number for SER 
in DD; I/O error in tape positioning or label 
processing; could not mount volume on 

device; more devices allocated than volumes. 











Attempting to open second DCB for same tape 
volume. 












I/O error in label processing or tape posi- 
tioning. 





Expiration date not reached, but data set 
opened for output and DD contained MOD in 
DISP. 








OPEN Verification error in label processing. 












Incorrect password entered; ASCII tape 
accessibility error, ASCII tape security error. 


Supplying 
password 
OPEN File sequence number in LABEL in DD 
incorrect. 
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OS/VS1 Completion Code Summary (con’‘t) 


Completion| Operation or 
Group |Code Macro Instruction Esplalioe 


OPEN OPEN for UCS Operator cancelled UCS load; incorrect UCS 
(SVC 13) printer image; space unavailable for DCB and DEB; 
(cont'd) SYS1.IMAGELIB not mounted or cataloged; 
permanent I/O error detected. 

I/O error in reading JFCB or DSCB for con- 
catenated data set; DSCB not found for one 
data set in concatenation; graphic device 
already opened by another task; output data 
sets concatenated. 































OPEN 





OPEN for graphics 





DCB for other than graphics device. 


OPEN for graphics | DCBGNCP field not 1 through 99. 














I/O error in tape positioning or volume 
disposition. 


1/O error reading DSCB. 


\/O error writing DSCB. 





I/O error reading JFCB. 
1/O error writing file mark. 
1/O error processing label, or tape mark. 


I/O error releasing unused direct access 
space. 







STOW unable to store, modify, or delete 
data from partitioned data set directory 

because name already in directory, no space 
available in directory, or I/O error search- 
ing directory. 


















CLOSE for 
graphics 


Graphic device not opened by closing task. 
















BSAM CLOSE 
with TYPE=T 


TCLOSE 
(SVC 17) 


I/O error in tape positioning or writing file 
mark. 





BSAM CLOSE 
with TYPE=T 





I/O error reading JFCB. 
















BSAM CLOSE 
with TYPE=T 


1/O error reading DSCB. 











BSAM CLOSE 
with TYPE=T 


|/O error writing updated DSCB. 












BSAM CLOSE 
with TYPE=T 


I/O error processing label or tape mark. 













Master 
sched- 
uler 


(SVC 22) 


Operator cancelled job; requested dump. 














Operator cancelled job; did not request 
dump. 





Execution of job step or cataloged procedure 
taking longer than time specified. 
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OS/VS1 Completion Code Summary (con’t) 


G Completion} Operation or Explanati 
OUP | Code Macro Instruction Anos 

























Master Job required too much queue space for 
sched - initiation. 
uler 
(SVC 22) All tasks in SVC wait state for 30 consec- 
(cont'd) utive minutes or for time specified in JWT 
parameter (in systems with SMF). 





WTO/ WTO, WTOR Parameter list not begin on proper boundary; 
WTOR no buffers available; text length equal to or 
(SVC 23) less than zero (WTOR only) . 





Reply command Invalid ECB, RB, or reply address. 
processing (in 


response to WTOR) 


EXTRACT 
EXTRACT 
EXTRACT 


















EXTRACT 
(SVC 28) 





Output list not on fullword boundry or not 
contained in storage assigned to job step. 





Input parameter list not on fullword boundary 
or does not begin in storage assigned to job 
step. 





TCB not for immediate subtask. 


ATTACH 
(SVC 2A) 


Address for ECB to be posted upon subtask 
termination is not multiple of 4, or not within 
bounds of partition. 


ATTACH 

ATTACH Exceeded allowed number of tasks. 
CHAP 
(SVC 2C) 


Address for subtask TCB does not point to TCB 
of immediate subtask, or points to a task that 
has terminated. 







Address for subtask TCB not multiple of 4. 
Overlay Words 3 and 4 of segment table invalid. 
super - 
visor 


(SVC 2D) 







Address in segment table or entry table 
outside storage for job step. 


Wrong length record or |/O error when load = 
ing segment. 









Invalid scatter record found while loading 
program segment. 


Invalid record type found while loading 
program segment. 









Invalid address found while loading program 
segment. 




















DEQ without 
RET = HAVE 


DEQ 
(SVC 30) 


DEQ for resource not enqueuved by prior ENQ 





DEQ 


Invalid length specified for name of resource. 





DEQ Invalid option specified by task with non= 


zero protection key. 





DEQ 





Invalid parameter list. 





DEQ Task does not yet control specified resource. 
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OS/VS1 Completion Code Summary (con't) 






















ENQ 
(SVC 38) 


DETACH 
(SVC 3E) 








SWAP 


Grows haa Operation or Explanation 
Macro Instruction 


' EOV End of volume 1/O error in label or tape mark processing or 
maa, (SVC 37) tape mark positioning. 

End of volume Verification error in label processing; tape 
label block count not same as DCB block 
count. 

End of data set No address specified in DCBEODAD field. 

e% End of volume Protect key different in TCBPKF field of TCB 
and DEBDEBID field of DEB. 

End of volume 1/O error in writing tape mark, positioning 
tape, reading label, sensing for file protect 
ring; DCB bit does not indicate concatena- 
tion of unlike attributes. 

ge 3 End of volume or Direct access I/O error; DSCB not found for 
allocation of multi- volume or concatenated data set. 
secondary quantity 

End of volume for | I/O error reading or writing JFCB from or 

sequential data set | onto direct access; JFCB extension needed 
but not found. 

End of volume Volumes must be demounted from a device 
allocated to the data set, but system unable 
to demount volume. 

Output operation More space needed but no secondary quantity 
specified for SPACE in DD. 

Output operation | More space needed but not enough volumes 
specifiedin SER, volume count, or REF in DD, 


CHKPT 





































































ENQ without 
RET=TEST, USE, 
or HAVE 


Second ENQ@ without intervening DEQ, 


ENQ Invalid length for resource name. 








ENQ Invalid option specified by task with non- 


zero protection key. 
Invalid parameter list. 


DETACH Subtask being detached not yet terminated. 








23E 





DETACH TCB address not on word boundary; subtask 


TCB not on word boundary; subtask TCB=0 or 
not an immediate subtask. 


7 Error during execution of checkpoint restart. 


|/O error in reading JFCB. 




















No foundation extension block in DCB; 





RDJFCB RDJFCB 
RDJFCB 


(SVC 55) 


EXLST address in DCB; JFCB exit in DCB exit 
list; JFCB buffer not in user's virtual storage. 







SVC 85 (in decimal) issued by user's task, but 
is restricted for use by Dynamic Device 
Reconfiguration. 
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OS/VS1 Completion Code Summary (con't) 


Completion} Operation or 
Grou Explanation 
Code Macro Instruction P 
System Job was being executed when system failure (aus 
Restart occurred; a system restart was performed. 


Supervi - Invalid operand, nn, in SVC instruction. 
sor Call 
(SVC nn) 












ESR 
(SVCs 
109, 116, 


Paging 028 Page file I/O error. 
0DO Invalid segment translation interrupt. 


Invalid ESR code in register 15. 


0D1 Invalid page - fault interrupt. 


Attention exit routine invalid. 


Step terminated at request of user appendage 
appendage HH. 


Execution of a task entered from a TSO 
terminal was stopped for one of these reasons: 
error while constructing contro! blocks for 
TSO; operator issued STOP TSO; terminal 
user signaled ATTN; job submitter disconnect 
ed his terminal from the system. 


OUTLIM keyword specified on SYSOUT DD 
statement exceeded. 


V=R region not obtained. 
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OS/VS2 Completion Code Summary 


Group Completion | Operation or Explanation 
Code Macro Instruction 


CHECK, GET, PUT | 1/O error; terminate specified or no SYNAD 


specified 


















Record is greater than 32,768 bytes; exceeds 
maximum track length or stated blocksize; 
could not be contained in one extent; too 
many tracks specified for cylinder overflow; 
or BDW or RDW (SDW) invalid 






7 
ell BSAM/ 
QSAM 


joe | EOB for 3525 3525 associated data set |/O sequence error 


004 OPEN for 3525/ | Invalid FORMAT card or invalid device 
3505 specified with OMR; conflicting or invalid 


DCB parameter; data protection image not 
found in SYS1.IMAGELIB 


S BSAM | 008 CHECK while | SYNAD returned to CHECK routine, but save 
creating data set | area was destroyed 
BDAM 020 OPEN Invalid DCBMACRF field or data set 
contained zero extents 
pos | Address in DCBSQND field outside task 
026 Processing with Invalid DCBXARG field or exclusive control 
exclusive control | status not indicated 
03D OPEN Missing format 2 DSCB or serial numbers not 
in order or not all present 
OPEN Invalid DCBMACRF field 
OPEN Invalid DCBMACRF field. 
033 


OPEN 


















I/O error reading highest level index or 
while reading the last prime data block or 
validating last record pointers; address in 
DCBMSHI field outside task or under incor- 
rect protection key 


OPEN No prime area specified 
OPEN User supplied buffers too small 


CLOSE [/O error writing updated format 2 DSCB 


DCBSMSI field specifies area too small for 


highest level index; invalid address in 


DCBMSWA 


OPEN DCBSMSW fields specify area to small for 
one track 
ie QISAM I/O error; no SYNAD specified 











QISAM ; 031 
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ye 


OS/VS2 Completion Code Summary (con't) 


Group Completion 
Code 
(con't) 
aa Scanning End of data set; no address in DCBEODAD 
field 





Operation or 
Macro Instruction 


Explanation 







Index area too small or crosses volumes 




















ISAM data set to be processed, but not 
created or its DCB not closed after creation; 
invalid DCBRKP field; DCBKEYLE field was 
zero; OPEN macro not issued for output; 
| BLKSIZE or LRECL specified incorrectly. 


OPEN No space available for resume loading 
















TCAM 040 OPEN Error in opening a TCAM line group data set 
OPEN Error in opening a TCAM message queves 

data set 

042 Processing Error in running a TCAM MCP with the 
telecommunication on-line test executive 
(TOTE) 

043 OPEN Error in opening a TCAM application 
| program data set 

044 Processing Error in processing the FE Common Write 
(COMWRITE) 

oa Message Control! | I/O error or logical read error 





eS (MCP) 


CLOSE TCAM MCP is scheduled to be terminated, 
application program data set active. 
Completion code is for the application 
program data set. 


Graphics! 056 Graphics attention] ANALYZ or GSERV specified DCB, which 
service routine pointed to DEB, which pointed to invalid 


UCB 





057 Graphics attention] ANALYZ or GSERV specified DCB, which 
service routine pointed to DEB, which pointed to UCB for 
other than graphics device. 


CLOSE CLOSE issued DAR for GACB that was not 
specified (via SPAR) by the closing task 


Graphics Sub- 
routine Package 
for FORTRAN IV, 
COBOL, and PL/I 










062 









Return code equal to or greater than 
absolute value of null argument produced 

















063 2250 operator pressed alphameric 


keyboard CANCEL key and selected DUMP 
or TERMINATE option to terminate program 


OPEN UCB for other than communications device 

OPEN UCB specified invalid or unsupported 
transmission control unit 

OPEN UCB specified invalid or unsupported 
terminal control or adapter 
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Execution of a 
graphic program 





BTAM 





OS/VS2 Completion Code Summary (con't) 
Group | Completion | Operation or Explanation 
Code Macro Instruction 
BTAM OPEN UCB specified invalid or unsupported type of 
yee (con't) terminal 
094 OPEN UCB specified invalid or unsupported 
optional feature or mode of operation 
095 OPEN Line group did not have identical terminal 
types and/or optional features 
OPEN DCBBFTEK field specified dynamic buffer 
allocation, but DCBBUFCB,DCBBUFNO, 
and DCBBUFL fields not spécified 


Leet OPEN Device I/O directory full 


OPEN 









Transmission control unit not a 2701 or the 
Dual Communication Interface, or Dual 
Code Feature not specified in UCB 















i Job 
Schedule 


Scheduler 
Initialization 
Program 


System failure or ABEND (dump given) 











Scheduler 
Initialization 
Program 


OBO I/O error in reading or writing 
SYS1.SYSJOBQE or SWADS 
Invalid TTR for SYS1.SYSJOBQE found by 
system conversion routine 

Prologue | OCx Program interruption, not in I/O interruption 

handler or type 1 SVC routine; no program 
routine to handle interruption; x=program 
interruption code 

for | Program interrupt in |/O interrupt handler 
Program interrupt in type 1 SVC routine or 
SVC first level interrupt handler (SVC FLIH) 
Machine-check interrupt; MCH able to 
abnormally terminate job step and continue 
operating system 

a a 







System failure or ABEND (no dump given) 








Program interruption while processing 
another program interruption 


EXCP \/O operation Device not operational or invalid use of 
(SVC 00) pseudo device 


\/O operation invalid ECB, 1OB, DCB protect key 





1/O operation Invalid DEB protect key; not enough extents 
in DEB. 


I/O operation Invalid DCB pointers 


1/O operation Invalid UCB address 
600 \/O operation Invalid EXCPVR request 
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OS/VS2 Completion Code Summary (con't) 


Group Completion | Operation or Explanation 
Code Macro Instruction 






/O operation Error on fix operation or page fault occurred 
within OS when it should not 


\/O operation A TIC could not be inserted in construction 
of a real channel program 


\/O operation 





PCI modify function required a page to be 
fixed or invalid IAL entry in PCI appendage 











\/O operation Overfix threshold exceeded and pages could | 
not be fixed 











coo I/O operation Number of page fix entries greater than 7 


\/O operation A reference could not be found in the 
validity map 


WAIT WAIT More events than ECBs 
(SVC 01 ae 
WAIT Invalid ECB address 


WAIT ECB wait flag already on 
POST POST Invalid ECB address 

(SVC m2) 

Invalid RB address in ECB 


RETURN or branch | Subtasks not yet terminated 
to return address in 
register 14 






























Task 
Termin- 
ation 


(SVC 03) 









RETURN or branch | TCBDEB points to DEB that is associated with 
to return address in| on invalid DCB. WARNING: all data sets 
register 14 not closed 


















RETURN or branch 
to return address in 
register 14 


Termination of task did not reset must-com- 
plete status 









GETMAIN|104 GETMAIN for 
program in 


supervisor made 










Not enough available real storage for local 
system queve area 






GETMAIN with 
LA and A operands 


GETMAIN 


Length and address lists cverlap 









Address in A or LA operand is outside task 
or is not multiple of 4; address of parameter 
lists invalid 


GETMAIN or More virtual storage requested than was 
language processor | was available 


pos | GETMAIN, | | GETMAIN | Subpool number greater than 127 Subpool number greater thon 127 | greater than 127 
FREEMAIN a FREEMAIN Area to be released not within correct 
subpool or not described by DQE 
FREEMAIN with Length and address lists overlap 
LA and A operands 


605 | Address in A or LA operand is outside task; 


a of parameter list in ‘alid 
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Address of area to be freed not multiple 
of 8 


OS/VS2 Completion Code Summary (con‘t) 


Group Completion | Operation or Explanation 
Code Macro Instruction 
FREEMAIN | A05 FREEMAIN Area to be freed overlaps existing free 
(con't) area 


FREEMAIN | Subpool number greater then 127 | number greater than 127 


FREEMAIN Attempt to free system queue space stor~- 
age not owned by task 


LINK, LOAD, 
ATTACH, XCTL 

































Contents 
Supervisor 
(SVC 06) 


Error while loading module into virtual 
storage; invalid record type, invalid 
address, I/O error 





















LINK, LOAD, 
XCTL, DELETE 


Address of parameter list invalid, address 
of name or directory entry invalid, or 
DE (if specified) not long enough 


LINK, ATTACH, | Module was only loadable 
XCTL 





06 


ib 
















Contents | 506 LINK, |.OAD, Not enough virtual storage for module 
Supervisor ATTACH, XCTL | and overlay supervisor 
(SVC 06) 















LINK, LOAD, 
ATTACH, XCTL 





Not enough virtual storage for module; or 
not enough real storage to fix requested 
module 


LINK, LOAD, Module marked "NOT EXECUTABLE" 
XCTL, DELETE 


LINK, LOAD BLDL detected error; module not found or 
ATTACH, XCTL I/O error during directory search, Also, 
SVC routine not in LPA 


uh 


806 



















More than 4096 users of a reenterable or 
serially reusable module 


LINK LOAD, Task already waiting for serially reusable 

XCTL, ATTACH module 

\/O activity Abnormally terminating system error task 
reinstated; user task abnormally terminated 


GETMAIN for 
program in 
supervisor mode 






GETMAIN, 

FREEMAIN 
with R 
operand 

(SVC OA) 


Not enough available storage in local 
system queve space 















ty 
So 
> 


Freeing region 
for new job step 


30A FREEMAIN Area to be released not within correct sub- 
pool or not described by DQE 
40A FREEMAIN Attempt to release all of subpool zero 
storage 
GETMAIN Not enough virtual storage available 


FREEMAIN Address of area to be freed not a multiple 
of 8 
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Storage still allocated to previous step 










OS/VS2 Completion Code Summary (con’t) 


Group Completion | Operation or Explanation 
Code Macro Instruction 





FREEMAIN Area to be freed overlaps on existing 
free area 


GETMAIN, Subpool number greater than 127 

FREEMAIN 

FREEMAIN Attempt to free system queue area storage 
not owned by task 


S [iet step task terminated 


(con't) 
















(SVC OD) 
ae enqueved for a resource that become 
permanently unavailable 


ABEND Invalid ABEND recursion during abnormal 
termination of subtask; job step terminated 


SPIE Sa 8, PICA address invalid 
(SVC 0E) 
a program attempted program 
interruption code 17 


- 


OPEN, OPEN with/I/O error reading or writing JFCB or in 
reading JFCB extension block; no exit code 
provided 












OPEN 
(SVC 13) 


Conflicting or unsupported paramters in DCB} 
member name specified in DD not found; no 
directory allocation subparameter in DD 








DSCB not found; I/O error in reading or 
writing DSCB; unable to locate PASSWORD 
data set 





OPEN 1/O error reading format 2 or 3 DSCB 


OPEN INPUT, specified but no serial number for 
SER in DD; I/O error in tape positioning or 
label processing; could not mount on device; 
more devices allocated than volumes 


OPEN Attempting to open second DCB for same tape  . 











volume 
OPEN \/O error in label processing or tape 
positioning 
OPEN Expiration date not reached, but data set 
opened for output and DD contained MOD 
in DISP a 
fas | OPEN Verification error in label processing 


Supplying password |Incorrect password entered; ASCII tape 
accessibility error, ASCII tape security 
error; unauthorized job step or job-step 
task attempted to open the VTOC for output 


Al3 OPEN File sequence number in LABEL on DD not 
corre ct 
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OS/VS2 Completion Code Summary (con’t) 


Group Completion| Operation or Explanation 
Code Macro Instruction 


OPEN OPEN for UCS Operator canceled UCS load; permanent [/O 
(SVC 13) printer error detected; space unavailable for DCB 
(con't) and DEB; SYS1.1IMAGELIB not mounted or 
cataloged. 































\/O error in reading JFCB or DSCB for 
concatenated data set; JFCB or DSCB not 
found for one data set in concatenation; 
graphic device already opened by another 
task; output data sets concatenated 


03 OPEN for graphics| DCB for other than graphics device 
pes | OPEN for graphics} DCBGNCP field not 1 through 99 


CLOSE 214 CLOSE 
(SVC 14) 












\/O error in tape positioning or volume 
disposition 















CLOSE I/O error reading DSCB 


[ofa [Vo weg cy 
[aw [aos |Vomrentn nce 


Al4 CLOSE I/O error releasing unused direct access 
space 


B14 CLOSE STOW unable to store, modify, or delete 
data from partitioned data set directory 
because name already in directory, no space 
available in directory, or |/O error 
searching directory 

DI4 CLOSE for Graphic device not opened by closing 

graphics task 

117 BSAM CLOSE with| I/O error positioning tape or writing file 

TYPE=T mark 
217 BSAM CLOSE with| I/O error reading JFCB 
TYPE=T 
317 BSAM CLOSE with| I/O error reading DSCB 
TYPE=T 
417 BSAM CLOSE with] I/O error writing updated DSCB 
TYPE=T 
717 BSAM CLOSE with| I/O error processing label or tape mark 
TYPE=T 










TCLOSE 
(SVC 17) 










Master 
Scheduler 
{SVC 22) 


el Operator cancelled job; requested dump 
Operator cancelled job; did not request 
dump 


Execution of job step or cataloged procedure 
taking longer than time specified 
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OS/VS2 Completion Code Summary (con’t) 


Group Completion} Operation or Explanation 
Code Macro Instruction 








Master Job required too much queue space for 
Scheduler initiation 


(SVC 22) 
(con't) 522 All tasks in SVC wait state for the length of 
time specified in the SMF parameter JWT 
Initiation of execution of task entered from 
TSO terminal terminated 


a enough real storage available for 
[ee program request for V=R region 








WTO/ A23 Queue waiting for | ABEND of communications task occurred 
WTOR ORE (operator 
(SVC 23) reply element) 


WTOR Request still unanswered when communica- 
tions task ABEND occurred 
WTO, WTRO Parameter list does not begin on proper 
boundary; no buffers available; WTOR/MLWTO 
parameter list specified 
Reply command Invalid ECB, RB, or reply address 
processing (in 


response to WTOR) 


EXTRACT EXTRACT Output list not on fullword boundary or not 
(SVC 28) contained in storage assigned to job step 
EXTRACT Input parameter list not on fullword bound- 
ary or does not begin in storage assigned to 
2a step 


= EXTRACT TCB not for immediate TB not for immediate subtask = 


ATTACH ATTACH Attempt to give shared subpool to new sub- 
(SVC 2A) ea 
cs ATTACH Subpoo! number greater thon 127 number greater than 127 


a ie | Attempt to give job pack queue, which 
a active programs, to new subtask a 


ATTACH Address for ECB to be posted upon subtask 
termination is not multiple of 4; not within 
bounds of partition 

ATTACH Insufficient LSQA storage to copy necessary 
ae information 


| 72q = [attacH 
not a multiple of 4, or points to a task that 


CHAP CHAP 
(SVC 2C) 
has terminated 
22C CHAP TCB address (for subtask) not multiple of 4, 
higher than hightest virtual storage, or does 
not have same protect key as CHAP issuer 
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Issuer specified invalid parameter address 









TCB address (for subtask) does not point to 
valid TCB or TCB of immediate subtask, is 









OS/VS2 Completion Code Summary (con't) 


Group Completion} Operation or Explanation 
Code Macro Instruction 
ps Supervisor 
fei pe 


Words 3 and 4 of segment table invalid 





Address in segment table or entry table 
outside storage for job step 


Wrong length record or I/O error when 
loading segment 


Invalid scatter record found while loading 
program segment 


Invalid record type found while loading 
program segment 


ie address found while eer | program 
ae | 


DEQ DEQ without RET= | DEQ for resource not enqueved by prior 
(SVC 30) HAVE ENQ 


a eee Invalid length specified for name of resource 


Invalid option specified by task with non- 
zero = key 


DEQ | Tok does not yet aa specified re source 


Ie [ofa eave 
(SVC 37) 
End of volume Verification error in label processing; tape 
label block count not same as DCB count 
(SVC 37) 
End of oa | Protect key different in TCBPKF field of TCB 
ene ee in DEBDEBID field of DEB 


End of Volume \/O error writing tape mark, positioning 
tape, reading label, sensing for file protect 
ring; DCB bit does not indicate concatena- 
tion of unlike attributes 


Direct Access I/O error; DSCB not found for 
multi-volume or concatenated data set 

























End of volume or 
allocation of 
secondary quantity 














End of volume for | I/O error reading or writing JFCB from or 
sequential data set] onto direct access; JFCB extension needed 
but not found 








Volumes must be demounted from a device 
allocated to the data set, but system unable 
to demount volume; DOS VTOC could not be 
converted to OS format 


Output operation | More space needed but no secondary 
quantity specified for SPACE in DD 


| End of volume 
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OS/VS2 Completion Code Summary (con't) 


Group Completion} Operation or Explanation 
Code Macro Instruction 


Output operation | More space needed but no more volumes 
specified in SER, volume count, or REF in 
DD; endcotvelume has found DSCB with a 
duplicate data set name on next volume 

ENQ without RET=| Second ENQ without intervening DEQ 


TEST, USE, or 
HAVE 


Invalid length for resource name 


Invalid option specified by task with non- 

zero a key 

a requested one-at-a-time access to a 

permanently unavailable resource 
DETACH se DETACH Subtask being detached not yet terminated 
(SVC 3E) 


DETACH Address of subtask TCB is not multiple of 4, 
is higher than highest virtual storage, does 
not have same protect key as DETACH issuer; 
address specified not valid TCB or TCB of 
immediate subtask 


ean cee Subtask being detached not yet terminated 
nc coe was specified) 
CHKPT ee il leo Error during execution of Error during execution of checkpoint restort_| restart 
RDJFCB a RDJFCB I/O error reading JFCB 


RDJFCB (1) No foundation extension block in DCB 

(2) No EXLST address in DCB 

(3) No JFCB exit in DCB exit list 

(4) JFCB buffer not in user's virtual storage 
SWAP 155 SVC 85 (in decimal) issued by user's task 
(SVC 55) but is restricted for use by Dynamic Device 

Reconfiguration 
System Job was being executed when system failure 
Restart occurred; a system restart was performed 


Supervisor Invalid operand, nn, in SVC instruction 
Call 
(SVC nn) 


Invalid ESR code in register 15 


116, 117) 


Paging poe fd Paging supervisor detected a system error 
poof Invalid segment translation interrupt 


Invalid page-fault interrupt 


Page translation exception while supervisor 
lock set 
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OS/VS2 Completion Code Summary (con’t) 


Group Completion} Operation or Explanation 
Code Macro Instruction 
Lo Unauthorized program requested a restricted 
SVC 


STATUS Program issued STATUS macro instruction for 
other than STOP/START function 


oe Attention exit routine invalid 


DEBCHK Function performed on a DEB obtained from 
the DCB passed by the program could not be 
completed 






















ABEND appendage} Step terminated at request of user appendage 








ABEND occurred while teleprocessing I/O 
are active or pending 


ABEND occurred while non-teleprocessing 
I/O are active or pending 


ii 
. 
. 
7° 
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2-32 


PLEASE COMMENT 


Use Reader’s Comment Form 
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Additonal information about the supervisor macro outlines and SVCs 
contained here is in Supervisor Services and Macros, GC27-6979. 


Supervisor Macro General Outline 


Macro 
Symbol Parameters 
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Supervisor Macros 


ABEND completion code[, DUMP][, STEP] 


ATTACH EP=symbol 
EPLOC=address of name ; [,DCB=dcb address] 
DE=address of list entry 





[, PARAM=(addresses)[, VL=1]][, ECB=ecb address] 


[, ETXR=exit routine address][, LPMOD=number] 


{, DPMOD=nt nber] 
, GSPV=number , SHSPV=number 
, GSPL=address of list , SHSPL=address of list 





[, SZERO=| YES }] [, TASKLIB=deb address] 

NO 

[, STAI=(exit address[, parameter list address])] 
NONE 


[, PURGE={ HALT | ASYNCH= {YI HI 
QUIESCE NO 








ATTACH EP=symbol 
(list form) EPLOC=address of name [| [, DCB=dcb address] 
DE=address of list entry 





[, ECB=ecb address] [, ETXR=exit routine address] 
[, LPMOD=number] [, DPMOD=number], SF=L 
, GSPV=number , HS PV=number 
, GSPL=address of list , SHSPL=address of list 
[, SZERO= (sel [, TASKLIB=deb address] 
NO 
[,S TAl=(exit address[, parameter list address])] 
NONE 
[,PURGE=} HALT —}] [, ASYNCH= { es ] 
QUIESCE NO 
ATTACH EP=symbol 
(execute EPLOC=address of name} [, DCB=dcb address] 
form) DE=oaddress of list entry 
|, PARAM=(addresses) [, VL=1]] [, ECB=ecb address] ws 
[, ETXR=exit routine address] [, LPMOD=number] 
[, DPMOD=number] 


, MF=(E, {Ftceren program list address ) 
(1) 


, SF=(E, alba i list address } ) 





si | | ), SFE, { a ) 


, GSPL=address of lis , SHS PL=address of list 


: GS PV=number | f SHSPV=number | 
t 


[, SZERO= eS }! [, TASKLIB=deb address] w 
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Supervisor Macros (con’t) 


[,STAI=(exit address[, parameter I{st address])] 


NONE 
[, PURGE= {raut } [, ASY NCH= bee }} 
QUIESCE NO 





(oy point name } [, (address porameters)[, VL]] 
(15) 


[, 1D=number] 


CALL , (address parameters) [, VL], MF=L 
(list form) 


CALL { entry point name | [, (address parameters)] 
(execute (15) 
form) 





[, WL] [, 1D=number] 


, MF=(E, {eoeen ota list et ) 


CHAP priority change value se location address 
; 1S! 


DELETE EP=symbol 
EPLOC=address of name 
DE=address of list entry 


(qname address ,rname address, [rname length} 


STEP |. .)[,RET=HAVE] 
SYSTEM 


DEQ ([qname address], [rname address], (rname length] 
(list form) 
eer ,+++)[,RET=HAVE], MFEL 

STEP 


DEQ [([qname address], [rname address], [rname length] 
(execute 
form) ' | 


SYSTEM a) |G ,RET=HAVE 
STEP , RET=NONE 


, MF=(E, ibd program list address }) 
(1) 


DETACH | teb location ie el 
O 


pene MSG=register } 
MSGLIST=address 


(qname address, rname address, [s li 7 {mame length] 








STEP ,RET=USE 
ers ,RET=HAVE 


,RET=CHNG 


SYSTEM ) ,RET=TEST 
¥ gees 
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Supervisor Macros (con’t) 


ENQ 
(list form) 


ENQ 
(execute 
form) 


EXTRACT 


EXTRACT 
(list form) 


EXTRACT 
(execute 
form) 


FREEMAIN 


FREEMAIN 
(list form) 


FREEMAIN 
(execute 
form) 


* V2 only 


3-4 





([qname address], [(rname address], [e 
S 


,RET=HAVE 
,RET=TEST 
,RET=USE 
,RET=CHNG 


7 MF=L 


,[rnome length] ,| SYSTEM | ,..-) 
STEP 


5 
i[rname length], |SYSTEM| ,...)][.RET=HAVE 
STEP , RET = TEST 
, RET =USE 
,RET=NONE 
,RET=CHNG 


[ ([qname address ],[rname address ] , g] 


, MF=(E, cons) da list aareis ) 
(l 


answer area address i tcb location | 
's§' 
, 


, FIELDS = (codes) 


rs 
[, FIELDS = (codes) ], MF=L 


[ answer area address ]} , tcb location saa 


[answer area address ] | ,tcb location a 
7 ‘s§! 
[ , FIELDS = (codes) } 


,MF=(E, joo) a list address }) 
1 


E, LV=number, A = address [, SP=number ] 
L, LA=address,A =address [, SP=number] * 
R, SP=number* 

R, SP=(0)* 

R, LV=(0) ,A =address 

R, LV=(0),A=(1) 

R, LV=number, A= address [, SP=number] 
R, LV=number, A=(1)[, SP = number] 
V,A=address [, SP=number] 


LJ[, LA=address][,A =address][, SP = number] * 
E ][, LV =number][ , A= address ][, SP= number] 
V][, A =address][, SP=number] 


[L ][, LA=address][, A =address][, SP=number ]* 
[E ]{, LV=number][,A = address ][, SP = number ] 
[V][,A = address ][, SP =number ] 


NES (ey oe program list see) 
(1) 
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Supervisor Macros (con’t) 


GETMAIN EC, LV=number, A= address [ , SP=number] pENDIY ee 


EU,LV=number, A=address [ ,SP=number][ ,BNDRY= Va 


LC, LA=address, A =address [, SP= pute BNDRY = 


LU, LA=address, A=address |, SP= cunball sNORY= {DL 


R, LV=number [, SP = number] 
R, LV=(0) 
VC, LA=address, A=address [, SP= need BNDRY= { 





PA 
VU, LA=address, A=address [, SP= scene BNDRY = {BoE 


GETMAIN {EC][, LV=number] 
(list form) [EU][, LV=number] 
[LC][, LA=address]* 
[LU] [, LA=address ]* 
[VC][, LA=address] 
{[VU][, LA=address] 


[, A=address][, SP=number] 





,BNDRY= | DBLWD | |, MF=L 
PAGE 


GETMAIN [EC] [, LV=number] 
(execute [EU] {,_LV=number] 


form) oak . pare . [, A=address][, SP=number] 


[VC][, LA=address] 
[VU][, LA=address] 


PAGE (1) 


GTRACE DATA=address, LNG=number, |D=number([, Fi D=number] 


GTRACE [DATA=address ][, LNG=length][, Fl D=number], MF=L 
(list form) 


eae ea | »MF=(E, a program list address } 





GTRACE {[DATA=address]{, LNG=length][, FiD=number] 

(execute 

form) ,|D=value, MF=(E, parameter list address ) 
(1-12) 


IDENTIFY { EP=symbol } ,ENTRY=entry point address 
EPLOC=address of name 


EPLOC=address of name 


| EP=symbol | [, DCB=deb address] 
DE=address of list entry 


{, PARAM=(addresses)](, VL=1]}[, [ID=number] 


(list form) EPLOC=address of name 


LINK |enocnn | |, DCB=deb address], SF=L 
DE=address of list entry 








*VS2 only 
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Supervisor Macros (con’t) 


(execute EPLOC=address of name 


LINK EP=symbol [, DCB=dcb address] 
form) DE=address of list entry 





([, PARAM=(addresses)][, VL=1][, |ID=number] 


, MF=(E, jpreaien program list ee ) 
(1) 
, oF=(E, { control program list address } ) 
(15) 
, MF=(E, pert } ), SF=(E, eta ) 
(1) (15) 





EPLOC=address of name 
DE=address of list entry 


PGRLSE sue (ane } , HA= ek 

(reg]) (reg2) 
PGRLSE MF=L[, LA=addr1)[, HA=addr2] 
(list form) 


PGRLSE MF=(E, { aa ) |,LA= ah ,HA= {addr2 
(execute (reg3) (reg!) {reo2)| 
form) 


| EP=symbol | [, DCB=deb address] 





POST ecb address[, completion code] 


RETURN | [(regl[,reg2I)Ii,T] f RC= fromber ] 
1 


SAVE (reg][,reg2])[, T][, identifier nome] 


DCBedeb address [TCB= { ar ][, | D=number] 
(reg) 


[,SDATA=(code for control program blocks)] 
[, PDATA=(code for problem program areas)] 


, STORAGE=(starting oddress, ending address, ...) 
,LIST=address of list 





SNAP- [DCB=deb address] [, |D=number] [, SDATA=(code)] 
(list form) 
[, PDATA=(code)] |, STORAGE=(address, address, ...) 

f LIST=address 


SNAP [DCB=dcb address] [, TCB= { address ] [, 1D=n umber] 
{execute '§! 
form) 





[, PDATA=code] [, SDATA=code] 


, STORAGE=(address, address, ...) 
,LIST=address 


,MF=(E, jon da list address } ) 


SPIE = [interruption exit address, (interruptions)] 


*VS2 only 
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Supervisor Macros (con’t) 


SPIE [interruption exit address] [, (interruptions)], MF=L 
(list form) 


SPIE 
(execute 
form) 

















[interruption exit address] [, (interruptions)| 





,MF=(E, oe program list tela ) 
(1) 


oh sacl : a 


{Nl 






















[, PARAMelist address] 





HALT NO 
NONE ~~ 





f PURGE= 





fat |] [ ASYNCH {YES} 











STAE [exit address][, PARAM=list address] 


(list form) 





HACT NO 


f PURGE= 
NONE 


QUIESCE | ee pea MF=L 















STAE {° } ,OV ] [, PARAM=list address] 
(execute exit address J L,CT 
form) 
Poe ] ,PURGE= [ QUIESCE oe thers ] 
NO HALT NO 
a NONE ~, 














,MF=(E, { remote list address } ) 
(1) 


STATUS { sia [, TCB=subtask tcb address] 
(VS82 only) STOP 


STIMER REAL[, timer completion exit address] 
| TASK[, timer completion exit address] 
WAIT 









, DINTVL=address 

, BINTVL=address 

, TUINTVL=address 
, TOD=address 
, MI C=address* 









DEC 
BIN- 

TU 

MIC, address 


TTIMER [CANCEL] [‘{ TU* }] 

MIC, address 3J* 

WAIT [number of events, | { EC B=address } 
ECBLIST=address 

WAITR [number of events, ] ieee } 
ECBLIST=address 


WTL ‘message’, MF=L 
(list form) 


*VS2 only 
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WTL 
(execute 
form) 


WTO 
(VS1 only) 


| WTO 
| (list form) 
(VS1 only) 


| WTO 
| (list form) 
(V82 only) 


| WTO 
| {execute 
form) 


WTOR 
(list form) 


WTOR 
(execute 
form) 


XCTL 
(list form) 


XCTL 
(execute 
form) 


Supervisor Macros (con't) 


MF=(E, baal program list asia 

(1) 
'message’ [, ROUTCDE=(number[, number. ..])] 
[, DESC=number] 
‘message’ [, ROUTCDE=(number[, number. . .])] 
[, DESC=number], MF=L 


‘message’ 


(‘text'[, line type]),... } [, ROUTCDE=(number[, number], ...)] 


{, DESC=(number[, number], ...)][, AREAID=char] 


‘message’ 
| (‘test'[, line. type]),... 


[, ROUTCDE=(number[, number], ...)] 
[, DESC=number], MF=L 
MF=(E, { control aia list nearest) 
) 
‘message’ reply address, length of reply 
‘ecb address[, ROUTCDE=(number[, number. ..])] 
[, DESC=n umber] 
‘message’, [reply address], [length of reply] 
, (ecb address ][, ROUTCDE=(number|, number ...])] 
{,DESC=number], MFEL 


, [reply address], [length of reply], [ecb address] 


,MF=(E, jonas! hag list address} ) 
1) 


[(regi[,reg2])], { EP=symbol 
EPLOC=address of ron 
DE=address of list entry 


[, OCB=deb address] 


EPLOC=address of name 


Exe 
DE=address of list entry 


|, DCB=dcb address}, SF=L 


,EPLOC=address of name 


[(reg][,reg2])] f EP=symbol 
, DE=address of list entry 


[, DCB=dcb address] 
,MF=(E, { problem program list address } ) 
(1) 


,SF=(E, (control program list address }) 
| (15) 
SFE, aa | ) 


,MF=(E, address 
(15) 


(1) 
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Valid Sup. Macro Parm Notation 


Abbreviation 


SYM 


DEC DIG 


REGISTER 


RX TYPE 


A-TYPE ADCON 
TYPE 


Meaning 
Any symbol valid in the assembler language. 


Any decimal digits, up to the value indicated in 
the associated macro instruction description. 
If both SYM and DEC DIG are checked, an 


absolute expression is also allowed. 


A general register, always coded within 
parentheses, as follows: 

one of the general registers 2 through 12, 
previously loaded with the right-adjusted value 
or address indicated in the macro-instruction 
description. The unused high-order bits must be 
set to zero. The register may be designated 
symbolically or with an absolute expression. 
general register 1, previously loaded as 
indicated above. Designate the register as (1) 
only. 

general register 0, previously loaded as 
indicated above. Designate the register as (0) 
only. 


Any address that is valid in an RX-type 
instruction (e.g., LA) may be designated. 


Any address that may be written in an A-type 
address constant may be designated. 
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Summary of Supervisor Operands 


| WRITTENAS sd AS 
MACRO Register 
INSTRUCTION OPERANDS Sym Dec 
12 


eg See 0 hal 


DUMP written as shown 


ATTACH ASYNCH= HYESerNO HYESerNO NO 


poe ey Pe Je 
et el ee 
jommooy ses] | || 
Ce a 
sc 
penoce Tt et | fe Js 
Cee ee 
ee ee 
pov [sefsefse]| | tT 
ee 2 eee ee 
ee eee 
QUIESCE, HALT, or NONE 
| i ae Ba ae 
ce 
fom dd dE 
ee 




















SZERO= YES or NO 


eae I Os ae 





written as shown 


fuer 
oa [emo [e] [[ [] ] 
address parameters Pt see. of. fess 
eT. 
priority change value pe RE tt 


tcb location address 


DeLee a 





mee REZ eor ee 


3-10 OS/VS Programmer’s Reference Digest 





Summary of Supervisor Operands (con’t) 


eral AS 
MACRO OPERANDS | Register | 
INSTRUCTION Sym ale RX= 
2) 


Some 
eee ee 







rname ee SLE |SLE|SE 





[STEP or SYSTEM | or SYSTEM written as shown 
Seg ne eae 2A a 


a a 
aa 5 

a CO 
Sane 35 2 a 

wa lomo dT ie 
a 


EorS written as shown 


newton vefeee] [T 


FREEMAIN E, L, RorV written as shown 


a 














A=(with R) 





os Ce te 
[eimai 
Towne ie PRP] | 
eco ew faaaebe] [|p 
frome RRL PP 
Sea 
~ TBI FE 


BNORY= DBLWD or PAGE 


ie ee eae 











Section 3: OS/VS Supervisor Information 3-11 





Summary of Supervisor Operands (con't) 


WRITTEN AS 


MACRO OPERANDS Register 
INSTRUCTION 


| LV=(with E) 








LV (with R) 





| SP=(with E, L, or V) 


SP=(with R) 





DATA= 








LNG= 


FID= 





ID= 





IDENTIFY ENTRY= 

pope aad 
| [Rey fT fe fo | 
Lae elie 














EPLOC= 











PGRLSE 


list addr= 





ecb address 


completion code 
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Summary of Supervisor Operands (con't) 


WRITTEN AS 
MACRO OPERANDS 
INSTRUCTION 








RETURN (reg],reg2) 


T 














refer to macro description 


vone | | [ee 
an Ce 


ree fe 
Tnenainwowes | | pe] | |e [a 


interruptions SLE 





STATUS STOP or START written as shown 


STIMER REAL, TASK or WAIT written as shown 
a 


fee 
timer completion exit addr Sete ae 
ox CRE 
one Cee 
CORE 
Cee ps 
DEC or BIN or TU written as shown 
written as shown 
a 


written as shown 

















TUINTVL= 














written as shown 
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Summary of Supervisor Operands ———_— 


L____wnirTen as___ AS 


MACRO | Register = 
INSTRUCTION OPERANDS Sym|Deg RX= 
Dig a (1) | (0) | type | type 


oe na 


|mesage any message within apostrophes 


ony mesoge within posrophes 
om | el] | | | 
Ley thee Wed 


message any message within apostrophes 


vem TTT Ie Te 
a 


ech address 








ROUTCDE= 
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Programming Conversion for SVC Routines 
Part of resident 
control program 
i 2048 bytes | Each load 
module £2048 
bytes 


Reenterable routine | Optional, but| Yes Yes Yes 
must be 
serially 
reusable 


May allow inter- No Yes Yes Yes 
ruptions 


Entry point Must be the first byte of the routine or load 
module, and must be on a double-word boundary 















Number of routine | Numbers assigned to your SVC routines should 
be in descending order from 255 through 200 


Register contents 
at entry time 


Registers 3, 4, 5, and 14 contain communication 
pointers; registers 0, 1, and 15 are parameter 
registers 


May contain reloca-| Yes Yes No No 
table data 

Can supervisor re- Not . Yes Yes 
quest block (SVRB) | applicable 

May issue WAIT No Yes Yes Yes 
macro instruction 

May issue XCTL No No No Yes 
macro instruction 

May pass control None Any 

o what other types 

lof SVC routines 


Type of linkage with 
other SVC routines 

































ies Issue supervisor call 
ies (SVC) instruction 





Exit from SVC Routine Branch using return register 14 

















Use ABEND 
macro instruction or 
resident abnormal 

termination routine 


Use resident 
abnormal 
termination 
routine 


Method of abnormal 
ermination 
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SVC Summary for OS/VS1 
Dec (hex) | Type} Macro Register 0 Register 1 
No. 
| 





EXCP {OB address 





| XDAP 


WAIT Event count ECB address of 2's complement 
of ECB list address 


WAITR 2's complement of event | ECB address or 2's complement 
count of ECB list address 





PRTOV 


| POST Completion code ECB address or parm list address 
with high-order bit on 


EXIT 


GETMAIN Parameter list address 





FREEMAIN Parameter list address 
LINK 
XCTL 


8(8) LOAD Address. of entry point DCB address 
address 


9(9) DELETE Address of program name 
10(A) GETMAIN | Subpool number (byte 0),| If negative, indicates GETMAIN. 
or length (bytes 1~3) If positive, contains address 
FREEMAIN of area to be freed 
11(B) TIME Pointer to a doubleword | Time units code 
to store TOD if MIC 
specified 
12(C) SYNCH 
13(D) ABEND Completion code 
14(E) SPIE PICA address , 2 


15(F) ERREXCP Address of request queve 
element 


16(10) PURGE 


17(11) RESTORE 1OB chain address 
18(12) BLDL Address of build list DCB address 
18(12) FIND 


19(13) OPEN Address of parameter list of 
DCB addresses 


20(14) CLOSE Address of parameter list of 
DCB addresses 





21(15) STOW Parameter list address DCB address 
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SVC Summary for OS/VS1 (con't) 


No. 


22(16) IV | OPEN Address of parameter list of 
TYPE=J DCB addresses 












23(17) IV | CLOSE Address of parameter list of 
TYPE=T DCB addresses 













24(18) Ill | DEVTYPE ddname address 






25(19) Hl = | TRKBAL DCB address 








26(1A) IV. | CATALOG Parameter list address 






26(1A) IV | INDEX Parameter list address 









26(1A) IV. | LOCATE Parameter list address 






27(1B) iil =| OBTAIN Parameter list address 









28(1C) IV | CVOL 






29(1D) IV | SCRATCH UCB address Parameter list address 









30(1E) RENAME UCB address Parameter list address 






31(1F) IV. | FEOV DCB address 






32(20) IV. | ALLOC Address of UCB list 






33(21) Wl =| IOHALT UCB address 





34(22) IV | MGCR 
(MAST CMD 
EXCP) 







34(22) IV | QEDIT 





35(23) IV | WTO Message address 








35(23) i/ | WTOR Message address 





36(24) IV} WTL Message address 








37(25) ll SEGLD Segment name addr 









37(25) I SEGWT Segment name addr 






38 (26) Reserved 






39(27) It} =| LABEL Parameter list address 









40(28) il EXTRACT Parameter list address 







41(29) I IDENTIFY | Entry point name address| Size of work area in 
doublewords 





42(2A) tl ATTACH May contain user parm list 
address 






43(2B) Ht =| CIRB Entry point address Size of work area in 
doublewords 








43(2B) il DIRB 
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SVC Summary for OS/VS1 (con’t) 


No. 


44(2C) li} =| CHAP +Increase priority TCB address 
~Decrease priority 















45(2D) i OVLYBRCH 





46(2E) TTIMER 1; Cancel 





47(2F) i] STIMER Exit address (Option Timer interval address 
flags in high order byte) 





48(30) I DEQ DEQ parameter list address 






49(31) Reserved 






50(32) Reserved 






51(33) IV | SNAP Parameter list address 









52(34) IV | RESTART DCB address 






53(35) Wi =| RELEX Key address DCB address 






54(36) i DISABLE 







§5(37) IV. | EOV EOB address DCB address 





56(38) i ENQ ENQ parameter list address 









57(39) li] | FREEDBUF | DECB address DCB adcress 






58(3A) il RELBUF DCB address 






58(3A) iI REQBUF DCB address 








59(3B) IV. | OLTEP 





60(3C) Il} | STAE 0 Create SCB Parameter list address 
4 Cancel SCB 
8 Overlay SCB 






61(3D) Reserved 









62(3E) il =| DETACH TCB address location 








63(3F) iV | CHKPT DCB address 


64(40) ill =| RDJFCB Address of parameter list of 
DCB addresses 









65(41) Reserved 






66(42) IV | BTAMTEST 






67(43) i ENDREADY QPOST 









68 (44) IV. | SYNADAF | Same as reg 0 on entry | Same as reg | on entry to 
to SYNAD SYNAD 









68 (44) IV | SNYADRLS 






69(45) Hit =| BSP DCB address 





70(46) iT GSERV Parameter list address 
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SVC Summary for OS/VS1 (con't) 





71(47) 


71(47) 




























7147) | WV 
7248) | IV 
7349) | AV 

w 744A) | 1V 
75(4B) | WI 
76(4c) | IV 
77(4D) 
78(4E) | IV 
80(50) 
81(51) | iv 
82(52) | IV 
93(53) | 1 

Ij esos) | 
a5(55) | IV 
86(56) | IV 
97(57) | ll 
88(58) | III 
99(59) | am 
90(5A) | IV 
91(58) | IV 


92(5C) - 101(65) 
102(66) | I 

103(67) | UII 
104(68) | IV 


105(69) I 


106(6A) 





107(6B) 


108(6C) 


Dec (hex) | T 
No. 


ype 
IV 





RLSEBFR 

ASGNBRF 

BUFINQ 

CHATR 

SPAR 

DAR 

DQUEUE 

IFBSTAT 
Reserved 


| DSCAN 





Reserved 
SETPRT 
DASDR 
SMFWTM 
GRAPHICS 
DDRSWAP 
ATLAS 
DOM 
MOD88 Routine Code 
EMSRV 


XOMNGR | Address of list of ECB/ 


IOB pointers (optional) 


VOLSTAT DCB address 


Reserved 
AQCTL 
XLATE 
TOPCTL 
IMAGLIB 
Reserved 
| MODESET | 


Reserved 
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Parameter list address 





Parameter list address 





Parameter list address 






Parameter list address 





Parameter list address 






Parameter list address 





Parameter list address 


















Message address 


Parameter list address 

DOM message ld if reg 0-0 
A pointer to a list of DOM 
message Ids if reg 0 negative. 
DCB address 


Parameter list address 
QMPA address 
Zero: issued by CLOSE 


Non~zero: issued by EOV 


Parameter list address 


Parameter list address 


3-19 


SVC Summary for OS/VS1 (con't) 


No. 


109(6D) 
110(6E) 
111(6F) 
112(70) 


113(71) 


114(72) 


115(73) 


116(74) 


117(75) 


118(76) 


Extended 
SVC Router 
(ESR) 


Parameters to ESR 


Reserved 
JECS 


PGRLSE Low address 


SIR ECB address or pointer 
to parameter list or 


contents ignored 
EXCPVR 
Reserved 


Extended Parameters to ESR 
SVC Router 


(ESR) 


Extended 
SVC Router 
(ESR) 


Parameters to ESR 


AT 
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Parameters to ESR 


High address 


Parameter word or PA 


Parameters to ESR 


Parameters to ESR 























SVC Summary for OS/VS2 


Dec (hex) | Type} Macro Register 0 Register 1 
No. 
P90) | 


EXCP IOB address 











XDAP 





WAIT Event count ECB address 











WAITR 





Event count 2's complement of ECB address 


PRTOV 





POST 







Completion code ECB address 


EXIT 






GETMAIN Parameter list address 










FREEMAIN Parameter list address 


LINK 





(Register 15 has Parameter list 
address) 
XCTL (Register 15 has Parameter list 
address) 








8(8) 





LOAD 











Address of entry point DCB address 


address 





9(9) 





DELETE Address of program name 








10(A) GETMAIN or Subpool number (byte 0) 
FREEMAIN  |Length (bytes 1-3) 


(R Operand) 


Address of area to be freed 














10(A) FREEPOOL 






11(B) Time units code 











12(C) 


(Register 15 contents 
branch address) 






13(D) Completion code 






14(E) PICA address 






15(F) 


Request queue address element 






16(10) 


Parameter list address 






Ry 17(11) 1OB chain address 









el 18(12) Address of build list DCB address 











18(12) Parameter list address DCB address 





19(13) Parameter list address of DCB 


addresses 








Parameter list address of DCB 


B| 20(14) 
ad addresses 











21(15) Parameter list address DCB address 
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SVC Summary for OS/VS2 (con’‘t) 


No. 


22(16) 


23(17) 


24(18) 
25(19) 
26(1A) 
26(1A) 
26(1A) 
27(1B) 
28(1C) 
29(1D) 
30(1E) 
31(1F) 
32(20) 
33(21) 
34(22) 
34(22) 
35(23) 
35(23) 
36(24) 
37(25) 
37(25) 
38(26) 
39(27) 
40(28) 
41(29) 


42(2A) 


43(2B) 


44(2C) 











IV 


IV 


Hl 


OPEN TYPE 

=J 

CLOSE 

TYPE=J 

DEVTYPE Output area address 

TRKBAL 

CATALOG 

INDEX 

LOCATE 

OBTAIN 

CVOL 

SCRATCH UCB address 

RENAME UCB address 

FEOV 

ALLOC 

IOHALT 

MGCR Indicator 

QEDIT 

WTO Console source ID 

WTOR Console source !D 

WTL 

SEGLD Entry code 

SEGWT Entry code 

Reserved 

LABEL 

EXTRACT 

IDENTIFY | Entry point name address 

ATTACH (Register 15 has super- 
visor parameter list 
address) 

CIRB Entry point address 

CHAP + Increase priority 


~ Decrease priority 
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Parameter list address of DCB 
addresses 





Parameter list address of DCB 
addresses 


Ddname address 


DCB address 





Parameter list address 
Parameter list address 
Parameter list address 


Parameter list address 





DCB or UCB address 
Parameter list address 
Parameter list address 
DCB address 

UCB list address 

UCB address 


Indicator 


Message address 
Message address 
Message address 
Parameter list address 


Parameter list address 


Parameter list address 
Parameter list address 
Entry point address 


Problem program parameter list 
address 





Size of work area in doublewords 


Address of TCB address 





SVC Summary for OS/VS2 (con’t) 


Dec (hex)| Type | Macro Register 0 Register ] 
No. 
I 


45(2D) | OVLYBRCH (Register 15 has entry point 
address) 













| TTIMER 1: Cancel time interval 





46(2E) 






47 (2F) STIMER Exit address Timer interval address 






48(30) Il DEQ Parameter list address 






49(31) 


Reserved 






50(32) Reserved 






51(33) IV | SNAP Parameter list address 






52(34) IV | RESTART. DCB address 





53(35) i} = | RELEX Key address DCB address 






54(36) I DISABLE DCB address 






55(37) IV. | EOV 1OB address DCB address 






56(38) I ENQ Parameter list address 






56(38) if RESERVE Parameter list address 






57 (39) I{{ | FREEDBUF | DECB address DCB address 






58(3A) I RELBUF DCB address 





58(3A) 






REQBUF 





Request count DCB address 








59(3B) lil =| OLTEP Parameter list address Code 





60(3C) ii | STAE 0 Create SCB Parameter list address 
4 Cancel SCB 


8 Overlay 






61(3D) Reserved 






$2(3E) il DETACH TCB address 







63(3F) IV | CHKPT Parameter list address 





64(40) Hl =| RDJFCB Parameter list address of DCB 


addresses 







65(41) Il QWAIT (Register 2 has QUEUE 


address) 






66(42) IV | BTAMTEST 1OB address 






67 (43) I ENDREADY QPOST 






68(44) IV. |SYNADAF | DECB or ICB address DCB address 






68(44) IV | SYNADRLS 






69(45) {Il | BSP DCB address 





70(46) i GSERV Parameter list address 
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/ 





SVC Summary for OS/VS2 (con't) 


71(47) 
71(47) 
72(48) 
73(49) 
74(4A) 
75(4B) 
76(4C) 
77(4D) 
78(4E) 
79(4F) 
80(50) 
81(51) 
82(52) 
83(53) 


84(54) 


85(55) 
86(56) 


87(57) 


88(58) 
89(59) 
90(5A) 
91(5B) 
92(5C) 


93(5D) 


94(5E) 
95(5F) 
96(60) 


97(61) 


Dec (hex) | Type 
No. 
| 


71(47) 





ASGNBFR 
BUFINQ 
RLSEBFR 
CHATR 
SPAR 

DAR 
DQUEUE 
IFBSTAT 
QTAMTEST 
WSCAN 
STATUS 
IKASVC 
SETPRT 
DASDR 
SMFWTM 


GRAPHICS 


DDRSWAP 
ATLAS 


DOM 


MOD88 
EMSRV 
XQMNGR 
VOLSTAT 
TCBEXCP 


TGET 
TPUT 


SsTCC 
TSEVENT 
STAX 


TEST-TSO 


IQE address 
RDE code 
Request address 
UCB address 
Start/Stop code 


Parameter list address 


UCB address and buffer 
restart address 


If zero 
If negative 


DCB address 
TCB address 


TJID & buffer 


Entry code 


TJID/Entry Code or 0 


TCB, PRB, IRB address 
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Parameter list address 
Parameter list address 
Parameter list address 
Parameter list address 
Parameter list address 
Parameter list address 
Parameter list address 
Record address 


Parameter list address 


TCB address 

Console address 
Parameter list address 
Parameter list address 


Message address 


Parameter list address 

A DOM message |. D. 

Address of list of DOM message 
IDs 

DCB address 

Parameter list address 

QMPA address 

issued code 


1OB address 


Address of User's Buffer 


Indicator 


Parameter List Address 


Values 

















SVC Summary for OS/VS2 (con't) 


98(62) 
99(63) 
100(64) 
101(65) 
102(66) 
103(67) 


104(68) 


105(69) 


107(6B) 


109(6D) 


110(6E) 


112(70) 


113(71) 


114(72) 
115(73) 


116(74) 


117(75) 


119(77) 








PROTECT 
DDDYNAM 
SUBMIT 
QTIP 
AQCTL 
XLATE 


TOPCTL 


IMAGLIB 


MODESET 


ESR 


DSTATUS 


RELEASE 


SIR 


EXCPVR 
BLKPAGE 


ESR 


ESR 


TESTAUTH 


Entry code 


Field length 


Subroutine indicator 


(Register 15 contains a 
routing code to appro- 
priate SVC routine) 


(Register 15 contains an 
indication) 


Starting address of 
virtual area 


+ Address of ECB 


- Address of ECB in-= 
direct area 


Function code 


Address of HASP 
vector table 


Function code 


+ Authorization code 
- No code 
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Parameter List Address 


Parameter List Address 


Save area Address 
Parameter List Address 
Action byte and field address 


Address of operator control 
work area 


Action indication 


Parameter list 


Address of CSCB 


End address of virtual area +1 


High order bit on - address of 
virtual subarea list 

High order bit off - first word 
of virtual subarea list 


Address of 1OB 


Address of SPCT 


Address of UCB or password 


Address of parameter list of DCB, 
or DEB 


Function code 
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Explanation of Style 












Explanation of style Footnotes; 


Words in all capitals are coded as shown; appropriate 
values are to be substituted for words in lower case * In full-word on full-word boundary 
letters, Shaded operands may only be used in a VS2 ** In double-word on double-word boundary 
system. Brackets, [ ], enclose operands that may be + Left justified in double-word on byte bounda 
used or omitted as required; stacking within braces, o Multiple of eight; value given in bytes 

i , is used to indicate a choice of operands or 
values. Underlining, __, indicates a default value. 








Load Module Control 


Pass contro! entry point name [, (address parameter [, address parameter]...){, VL] ] 
and initiate 
execution {, 1D=0 to 65535] 


Dynamically EP=entry point name 
load and EPLOC=address of entry point name* ) [,DCB=dcb address] 
initiate DE=address of list entry 
execution 
{, PARAM=(address parameter [, address parameter]...) [, VL=1] ] 


[,1D=0 to 65535] 
Transfer EP=entry point name 


control [(register (s) 2~12)], ( EPLOC=address of entry point name 
DE-address of list entry 


+ 


[, DCB=deb address] 


Dynamically EP=entry point name 
load EPLOC=address of entry point name* ) [, DCB=dcb address] 
DE=address of list entry 


DELETE EP=entry point name 
EPLOC=address of entry point name 
DE=address of list entry 


+ 





Identify IDENTIFY EP=entry point name ,ENTRY=entry point address 
embedded EPLOC=address of entry point namet 


entry point 





Load external segment name 
overlay 
segment 
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Synchronization 


Wait for 
event 


Wait for even 


while lower 
priority task 
is executed 


Post event 
completion 


Request 
control of 
serially 
reusable 
resource 


Release 
serially 
reusable 
resource 


Set interval 
timer 


WAIT [number of events, ] | ECB=ech address 
ECBLIST=address of list of ecb addresses* 


[number of events,] } ECB=ecb address 
ECBLIST=address of list of ecb addresses* 


POST ech address [,0 to 16,777,215] 


(qname address, rname address, | E |, [rname length], | SYSTEM| ,...) 
5 STEP. 


,RET=TEST 
,RET=USE 
,RET=HAVE 
,RET=CHNG 


(qname address, rname address, [rname length], ee ] ston) 
SYSTEM 
[,RET=HAVE] 
E means exclusive control 
S means shared control 


} default is E 


SYSTEM means resource used by more than one job 
STEP = means resource used by issuing job 





REAL, [address of interval end routine] 
TASK, [address of interval end routine] 
WAIT 


,DINTVL=address of decimal interval ** 

, BINTVL=address of binary interval in seconds* 

, TUINTVL=address of binary interval in timer units* 
, TOD=address of time-of-day of interval end** 


| Test interval TTIMER fe ; 
timer pee ; 


TIME AND TIME INTERVALS FOR TIME, TTIMER, AND STIMER 


Decimal (DEC and DINTVL operands): 
Eight packed decimal digits in format 
HHMMSSth 

HH = hours in 24-hour clock 


Binary in seconds (BIN or BINTVL operands): 
Unsigned 32-bit binary number in a full-word on 
full-word boundary; least significant bit has a 
valve of 0.01 second 


MM = minutes 


SS = seconds 
t = tenths of seconds 
h = hundredths of seconds 


Binary in timer units (TU or TUINTVL operands): 
Unsigned 32-bit binary number in a full-word on 
full-word boundary; least significant bit has a 
value of I timer unit (Itimer unit = 26 micro- 
seconds} 


Binary in microseconds (MIC operand): 
Unsigned 64-bit binary number in a double-word 
on a double-word boundary. Bit 51 is the low 
order digit of the interval value. 
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Program Interruption Control 


(see axplanation of style - page 3-26) 


Enable and [interruption exit routine address] 

disable 

program [, (interruption type[, interruption type]...)] 
interruptions 

and transfer 

control to 

interruption 

exit routine 


INTERRUPTION TYPES FOR SPIE 


Type Meaning Maskable Meaning Maskable 


Operation Fixed-point divide No 
Privileged operation Decimal overflow Yes 
Execute Decimal divide No 
Protection Exponent overflow No 
Addressing Exponent underflow Yes 
Specification Significance Yes 
Data Floating-point divide No 
Fixed=point overflow 


Onoanrwn — 


CONTROL BLOCKS 
Event control block (ECB): Program interruption control area (PICA): 


Qo 1 2 31 bits 0 1 2 3.4 


ms 


W = wait flag | 0000 | gram exit routine interruption 
C = completion flag ' mask address mask 


Program interruption element (PIE): 
2 3 bytes 


PICA address 


Old Program Status Word 
after interruption 
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General Services 
(see explanation of style - page 3-26) 
Delete MSGeregister containing 24-bit, right-justified message number 


message(s) MSGLIST=address of list of fullwords, each a 24-bit, right-justified 
‘ identification number of message to be deleted 


iE: 
eas A 


‘message’ [, ROUTCDE=(number [, number] ,...)] 





Write to *message', address of reply area, length of reply, ecb address 
operator 


and wait [,ROUTCDE=(number [,number] ,...)}] [, DESC=message descriptor code(s} 
for reply 


Write to WTL *message' 
log 
R 


Divide DX 
extended 


recision Only registers 0 and 4 can be used; 
floating they may be specified in either order, 


point number 


register containing dividend, register containing divisor 


Get time DEC 

and date BIN 

TU 

MIC, address 





TIME AND TIME INTERVALS FOR TIME, TTIMER, AND STIMER 


Decimal (DEC and DINTVL operands): Binary in seconds (BIN or BINTVL operands): 
Eight packed decimal digits in format Unsigned 32-bit binary number in a full-word on full- 
HHMMSSth word boundary; least significant bit has a value of 
0.01 second 
HH = hours in 24-hour clock 
MM = minutes Binary in timer units (TU or TUINTVL operands): 
SS = seconds Unsigned 32-bit binary number in a full-word on full- 
t = tenths of seconds word bondary; least significant bit has a value of 1 
h = hundredths of seconds timer unit (1 timer unit = 26 micro-seconds) 


Binary in microseconds (MIC operand): 
Unsigned 64-bit binary number in a double-word on a 
double-word boundary. Bit 51 is the low order digit 
of the interval value. 
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General Services (con’t) 


(see explanation of style - page 3-26) 


Save SAVE (register(s) 14 through 12) [,T] [, identifier] 
register 


contents In SAVE, T means: save 
registers 14 and 15. 





Dump SNAP DCB=address of data control block [, TCB=address of TCB address*] 
storage 
and continue 


[,ID=1 to 127] 


ALL ]},ALL 

Nuc ||, NUC 
[,SDATA=( ¢TRT \{,TRT | ...)] 

cB ,CB 

Q ,Q 


ALL /ALL 
PSW 
REGS 
[, PDATA=(\ SA or SAH 7SA or ,SAH eee] 
JPA or LPA or ALLPA , JPA or ,LPA or , ALLPA 
SPLS , SPLS 


SNAP SDATA VALUES 


all of the following fields 

all of nucleus except trace table 

trace table 

TCB, active RBs, JPACQ, and MSS control blocks 


SNAP PDATA VALUES 


all of the following fields (assume SA and ALLPA) 
Program Status Word when SNAP was issued 
contents of general registers when SNAP was issued 
linkage information and back trace 

linkage information only 

all virtual storage assigned to job step 

contents of resident reenterable load module 

JPA + LPA 

contents of virtual storage subpools 0 - 127 


hououd 





, LIST = address of list 


Record GTRACE DATA=address, LNG=number of bytes of data, !|D=record 1D 
trace data 
[,F1D=format identifier routine] 


[ , STORAGE = (starting address, ending address, .. | 





Termination P 


Terminate [(register(s) 14 through 12)] [,T] [ (; RC=0 to | 












normally RC=(15) 


In RETURN, T means: place all ones 

in high-order byte of save area word 4, 
Terminate ABEND 
abnormal | 





0 to 4095, [DUMP] [, STEP] 


3-30 OS/VS Programmer’s Reference Digest 


Task Control 


(see explanation of style - page 3-26) 





Dynamically ATTACH EP=entry point name 

load and EPLOC=address of entry point name* }[,DCB=dceb address] 
initiate DE=address of name field of list entry 

execution 

{, PARAM=(address parameter [, address parameter]...) [, VL= Ill 


[, ECB=ecb address} [, ETXR=address of routine to be entered when] 
subtask terminates 


[,LPMOD=number subtracted from limit priority] 

















DETACH 


ae Re 


CHAP signed number to be algebrai 


cally added to dispatching priority 


'S' indicates that the priority of the 
active task is to be changed. 


, address of tcb address 


3 
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Virtual Storage Allocation 
(see explanation of style - page 3-26) 












Allocate GETMAIN R,LV=length® [,SP=0 to 127] 
storage 
GETMAIN | eat ,LV=length® 
EU 





,A=address of specification lis ' 
ye aca of length® list 
VU 





J 


[,SP=0 to 127] [, od omer | 





FREEMAIN R,LV=length°, A=address of storage area address* list [,SP=0O to 127] « 


FREEMAIN 
Vv 


MODE OPERANDS FOR GETMAIN AND FREEMAIN 


| E, LV=length° oe of storage area address* list [,SP=0 to 127] 


R=register type 
E=single area, fixed length 
V=single area, variable length 
L=virtual area(s), variable length(s) 
U-unconditional 
=conditional 
oe 


PGRLSE LA=low address of area, HA=high address*] of area 
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Section 4: OS/VS1 Data Management 


Data Management Macros 4-2 
DASD Capacities 4-13 

IBM Standard Tape Labels 4-14 
ANSI Standard Tape Labels 4-20 





Source Publications 





Details of data management macros for BsAM, BDAM, BPAM, 
BISAM, QSAM, and QISAM, as well as DASD track capacities, are 
found in OS/VS Data Management Macro Instructions, GC26-3793. 
é 4 You can obtain additional tape label information from 
e OS/VS Tape Labels, GC26-3795 


For information about MICR/OCR data management refer to these 
publications: 


e OS Data Management Services and Macro Instructions for 
IBM 1419/1275, GC21-5006 


e OS Data Management Services and Macro Instructions for 
IBM 1285/1287/1288, GC21-5004 
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Data Management Macros - Introduction 


Data Management Macros for: 


BDAM 
BSAM 
BPAM 


BISAM 
QSAM 
QISAM 





Completion codes for D/M macros are contained in the low-order byte of general 
register 15. Unless otherwise indicated the letter codes used here mean: 





A- Successful completion. 

B- Completion, but one or more errors occurred that may invalidate 
the results of macro execution. 

C= Permanent |/O error 

D- Track, block, or device address not within data set. 

E- Not complete or no operation performed. 





Data Management Macros 


Completion 
Codes 


}00=A 
04=B 
08=C 


Parameters 





list address 
(2-12) 
(0) 


{deb address}, 
(1-12) 
©) 


deb address 
(1 - 12) 











00=A 
04=8 

08=E 
(SYSIN or 
SYSOUT) 





number of buffers 


(2= 12) 


, {buffer length! 
(2~ 12) 


(0) 


aie ( 





QSAM |BUILDRCD buffer length 


(22°12) 


number of buffers 
(2-12) 


if 


area address ; 
(2= 12) 
record area length 
(2-12) 


| | 


; 


record area address 
(2-12) 
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Data Management Macros (con’t) 


QSAM/BUILDRCD]| area address, number of buffers, buffer length 
(list, form) 
,record area address[, record area length], MF =L 


BUILDRCD| [area address|, [number of buffers], [buffer length] 
(execute (2-12) 
form) 

|e area aa 7 [record area length] 


(2~ 12) 


i oa program list ca 
(1) 


decb orl dics i 
(1-12) ALL 


dcb address[, checkid address [, checkid length] ] 00=Success- 
<o ful comple- 
CANCEL tion 
04=Restart 
occurred 
08=Unsuc- 
cessful com= 


0C=Unsuc~ 
cessful com- 
pletion: 

1/O error 
10=Success=- 
ful comple- 
tion: 

Possible 

error 








CHKPT ; 
(list form) | [deb address], [checkid eaHenl event ior 
'S! 





CHKPT [ deb address],[checkid elites ieee lena 
(execute 'S' 
form) ,MF=(E, feonte) program list at 

(1) 
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Data Management Macros (con’‘t) 


Completion 
Macro Parameters 


LEAVE DELETE 
REWIND KEEP 
CATLG 
UNCATLG 


(deb mee ,DISP= { PASS 


[TYPE=T]}* 


, LEAVE DELETE 


REWIND 


([deb “el tee PASS ben) 


KEEP 
CATLG 
UNCATLG 


[, TYPE=T]*,MF=L 


DELETE 


f 


, REWIND 


(execute 


form) KEEP 


CATLG 
UNCATLG 


[, TYPE=T]*,MF= sr management list address 
(1) 


BSAM {CNTRL deb address, ( SS,) 1 
QSAM 2 


1 
se,j2\ 
3 
1 
sk, though! 
12 


BSM 
FSM 
BSR[, number of blocks 
palin of blocky 
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CLOSE ([deb mf itexe ,DISP= { PASS | peta!) 
VE 


\ 


Not avail = 
able to user 
program 














Data Management Macros (con’t) 


Completion 


The DCB macro is too complex to properly document 
in this publication. For information about this macro, 
please refer to OS/VS Data Management Macro 
Instructions, GC26- 3793. 











iii = (([BS]L DAIL ISIE LRIL POJL PSL, il 
GS 


[,DEVD=( [DA]L, PC], PRIL-PTJL, RDJL, TA]L, MR]) | 


QISAM /ESETL ee aren 
{in spt 
BSAM |FEOV ee address TaTooe Tl 
QSAM (- ot LEAVE 


Data Management Macros (con’t) 


Completion 
jam | eco | Poems a 
































BPAM {FIND deb ot , { (name address ) , 00=A 
{ (1- 12) (2-12) i 04=8 
(0) 08=C 
relative address list ),C Note: 
(2-12) \ reladr, C 
(0) always 
returns 
a ee es ee of 00 





BDAM jFREEBUF dcb address 


{ (1-12) 





aoam Jraeeaur | fach addres) regiter® J ,register* 





*Note: Reg, any of 2 to 12, 
contains addr of buffer. 


dech address) ,{K)} , {deb address) 
ries) 
0 































a a 
(1~ 12) 



















dcb address} [, (area address 
{ (1-12) ak (2-12) 1 


(0) 






QISAM] GET 
QSAM 
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Data Management Macros (con’‘t) 


ae 
Macro Parameters Cadac 


ae rat ,tegister* 
(1-12) 

*Note: Reg, any of 2 to 12, is where the system will 
place the buffer address. 


{ = | F { are a } “ri 


( fdeb — DAM [OPEN | (fdebaddress| ,[loptions)],...) | | | 
(2-12) 





Data Management Macros (con’t) 


Completion 


BDAM | OPEN ([dcb address] ,[(options)],...),MF=L 
BISAM | (list form) 


[( ie ar) + L(options)],...)] 


/MF= al management list oe, 
(1) 





Open Macro Options 





DEVICE TYPE 


ACCESS 
METHOD MAGNETIC TAPE DIRECT ACCESS OTHER TYPES 


Option] Option 2 Option | Option 2 Option 1 Option 2 
QSAM INPUT REREAD INPUT REREAD INPUT 
OUTPUT j} , LEAVE OUTPUT LEAVE OUTPUT 
RDBACK _||_,DISP UPDAT ,DISP — 


INPUT REREAD [ INPUT | vise 
Output || ,LEAVE || LOUTPUT| — (gyal 
/DISP 

































INPUT , REREAD 
OUTPUT || ,LEAVE 
INOUT |] ,DISP 
OUTIN 

ROBACK 


QISAM 
(Load Mode) [ OuTPUT ] 
BPAM, Suter = 
BDAM Suter =F as 
UPDAT 


Optionally select one from vertical stack within [ ] 


BSAM 
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Data Management Macros (con’t) 
Completion 
A/M Macro Parameters Codes 
BPAM POINT dcb address /, \block address 
BSAM 


(1-12) (2-12) 


(0) 
BSAM PRTOV ee address |, , Joverflow exit address 
_QSAM | (212) : 2 (2=12) 

































Qisam | pur deb ras , \area address 
QSAM (1-12) (2-12) 
QISAM deb address , \input deb address 
QSAM (1-12) (2-12) 

(0) 











decb name, { DI F he a 
DK (2-12) (2-12) 
DIF \R 'S! 
DIX [FRU 
; DKF 
& F DKX' 
, (length ), {key address ), (block address} [, (next address 
jena (2-12) (2-12) ie (2-12) 
'S' 


decb name, za sera a ta eae 
(2= 12) (2+ 12) 





BISAM |READ decb ba re na area address) , (length 
KU (2-12) (2= 12) {@n12) 
‘st 


. 12 at 
(2-12) 





BPAM |READ decb name, {eat ; ie ea { orea a , (length 
SB (2-12) (2-12) jen) 
'§! 
decb name, type*, [deb address] , (ae ral ; ee 
iS tS 


; iy ras P [block address | ; [next address | , MF=L 
'S! 


*Note: type will be one of the parameters (e.g., K,SF, 
DI) frora the applicable standard form of the READ macro. 
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Data Management Macros (con’t) 


Condition 
pm [Meco | Params ton 
ee oraal baal sr ra | area address |,| length 

(2-12) (2-12) (2-12) '§! 
'S! 
, | key address] ,| block address] ,|mext oddress} , MF=E 
(2-12) (2+12) (2-12) 
S$! 


*Note: type will be one of the parameters (e.g., K, SF, Dl) 
from the applicable standard form of the READ macro. 










































BDAM | RELEX Df 
(2-12) (2-12) 


(0) 
QISAM | RELSE 1 ea 
QSAM (1-12) 


QISAM | SETL 7 wrhata K[H] (,lower limit address 
(1-12) KC 


Data Management Macros (con’t) 


deb cae ; ne: ray 


















Completion 
Parameters 


an | Mec 
BSAM | SETPRT ‘ae ee} 
QSAM (2-12) 
iF ep 
,UCS=(cse | ,F [OLD], V[ERIFY]}) 
1+ LERIFY] 
[, FCB=(image-id| , V[ERIFY]])] peas oe by 
,ALLIGN “AW Pa 
,FCB=(image -id |, V[ERIFY JE OeTeDa (yey F[OLO] = )} wd) 
,ALLIGN us}, ULNFOLO] 
Orn (ey ,Ffouo] |) 
US |,U[NFOLD] 
SETPRT Completion Codes 
FCB ucs FCB/UCS 
Bits 16-23 Bits 24-31 Bits 24-31 fa 
| 00 00 Successful completion 18 NOP; incorrect wi 
ificati 
| 04 04 Operator cancellation ey ores 
] 1c NOP: error during 
08 08 oe previous 1/O attempt 
20 Insufficient space 
oc oc scbiloniede® /O error for IMAGELIB blocks 
uring 
10 10 Permanent 1/O error 24 Unable to open 
during mage dteploy SYS]. IMAGELIB Say 
14 14 Operator cancellation: wi 
incorrect image 
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Data Management Macros (con’t) 


P. ‘ Completion 
A/M Macro Srame ters Codes 


BSAM |SETPRT deb address 


QSAMI (list form) 
oon 
,UCS=(ese| ,F [OLD] ,V [ERIFY]]) 


VERIFY] 


[,FCB=(image-id : v eeap [ OPTCD = {¢ y] 
,FCB=(image-id Reese at foul i 


,ALLIGN U[NFOLD| 


oreo rc} 
























deb ena 
(2-12) 


F beret 
,UCS=(cse | ,F [OLD], V[ERIFY]) 
1+¥[ERIFY] 


Mere eel rly EOmD: {2 | 
ALLIGN U 


lea att icaabbadas HA ] 
,A[LIGN Us|, UINFOLD 


once ORD 


MF=(E, fon management list ey ) 
(1-12) 
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Data Management Macros (con't) 


Completion 
P t 
saree abba ker 


deb address) , (list address ay A] 
{ (1-12) } (2-12) : 
(0) D 





Successful 
00 |completion 


Name already in New nome already 

directory in directory 
Name not Old name not 
found eo 

0 No space in directory 

Permanent |/O error 

in directory 

Specified data con= 

14 |trol block not open 
Conditional 


GETMAIN unsuccess= 
ful 

















SYNADAF |, ACSMETH=8DAM 00=A with 
\ACSMETH=BPAM no msg 
« ACSMETH=BSAM : 7 04=A with 
/PARMI= *}[/ PARM2= ‘ 
ACSMETH=QSAM ( | parm ree ll aries a (ee 
“ACSMETH=BISAM 08=8 
ACSMETH=EXCP [ -PARMI = {is eden} ] 
(1-12) 


aa eat PARMI =fdeb hag) Naa reg**] 
(1-12) 
*Note: Any of registers 1 to 12 
**Note: Any of registers 0 or 2 through 12. 


SYNADRLS 
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Data Management Macros (con’t) 


Cc leti 
eam ae deb address 
ae (1-12) } 


BSAM  |WRITE dech name, (SF ),{dcb address sae? ia 
SER (2-12) \ (2-72) 
sD 
, length] [,next address 
Fi 'S! 


Meaning 


Fixed - Length Variable or Unspecified Length 
(SF or SD) (SF or SFR) (SZ) 


Block written. (If previous return | Capacity record 
code was 08, block written only | written; another 
if the DD statement specifies track available. 
secondary space allocation and 
sufficient space available.) 














































Block written, fol- | Block not 
lowed by capacity | written; 
record. write a 
capacity 
record (SZ) 
to complete 
current track 
then reissue. 
























Capacity record was 
written, 

Next block requires 
secondary space al- 
location. This code 
not issued if WRITE 
$Z is only WRITE 
macro instruction 
issued on a one- 
track secondary 


Block written, 
followed by capac- 
ity record. Next 
block requires 
secondary spece 
allocation. 































Block will not be written; issue a CHECK macro instruc 
tion for the previous WRITE macro, then reissue the 


BDAM | WRITE decb name, { DA eae serra area address 
DAF (2-12) (2-12) 
DI "Ss! 
DIF 
DK 
DKF 
DKX 
, (length ), (key address aaa address 
} 'S! (2-12) (2-12) \ 
(2-12) 's! 
0 


BISAM | WRITE | decbh name, { K ae reg , (area address 
KN (2-12) (2-12) 






































iS! 
,( length ey ert 
(2-12) (2-12) 
's! 
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Data Management Macros (con’t) 


Completion 
A/M Macro | Parameters Codes 


decb name, SF, a oo ot Rreae i] 


(2-12) (2-12) (2=12) 


! 


decb name, type*, [dcb address | diner | 
'§! 
; Baas ‘Naa , [block address] , [next address] , 
'S' 1 s' 

*Note: type will be one of the keyword 
parameters (e.g., SF, DA, K) om 
from the applicable standard form 
of the WRITE macro. 

















(2-12) (2-12) (2-12) 


{ decb ad type’, [33 ard area address 
1 S$! 


+ | length], [key address ‘has reruiaall bat siete 
(2=12) (2—12) (2=12) (2=12) 
'$' "S$! 

MF=E 





*Note: type will be one of the keyword 
parameters (e.g., SF, DA, K) 
from the applicable standard 
form of the WRITE macro. 





Data Management Macros (con’t) 


Completion 


easiest 
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Direct Access Device Capacities 

Device | Volume | Track Tracks/ No. of Total 

Type Type Capacity | Cylinder | Cylinders | Capacity 
2314/ 7294 29,176,000 
3 


3330 | | Disk | 13030 oe 101,751,270 751,270 


fos] om [we [© [samme 
a ae ee eee 



















Device | Blocks with keys Blocks without keys 


ce | fe |, ne a) 
2314/ | 146 +934 (KL+DL) | 45+KL+DL [101+ 2594(DL)} DL 
2319 512 512 

191+KL+DL | 135+DL 135+DL 


3330 
2305-1 632+KL+DL 632+KL+DL | 430+DL 430+DL 


2305-2 289+KL+DL 289+KL+DL | 198+DL 198+DL 


Bi is any block but the last on the track 
Bn is the last block on the track 

KL is the key length 
DL is the data length 


















191+KL+DL 
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Volume Organization with IBM Standard Labels 


Single Data Set Single Data Set 
Single Volume Multiple Volumes 






Volume Label 


Data Set a 
Header Labels 


User Header 
Labels 











} Data Set 


Trailer Labels 


User Trailer 


Labels 


\ End of 
Data Set 


Single Data Set/Single Volume: The volume label is followed by the data 
set header labelsgand optional user header labels, The data set is preceded 
and followed by a tapemark. The data set trailer labels are identified as 
EOF and followed by optional user trailer labels. Two tapemarks follow the 
trailer label group to indicate that the data set is the last data set on the 
volume and is not continued on another volume. 


Single Data Set/Multiple Volumes: More than one volume is needed to contain 
the data set. The last volume is organized the same asa single volume. On 
the other volumes, the data set trailer labels are identified as EOV instead of 
EOF, and the trailer label group is followed by one tapemark instead of two. 
The data set and user labels are repeated on each volume, and there is a 
separate volume label for each tape. 
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my 


Volume Organization with IBM Standard Labels (con’t) 


Multiple Data Sets 
Multiple Volumes 
Multiple Data Sets 
Single Volume Vol 1 of 3 Vol 2 of 3 Vol 3 of 3 





| 


Data Set B 
Continued 





UTLn 
T™M 


aot] 
| UTLn 
[TM 
i ae 





Multiple Data Sets/Single Volume: The tape begins with a volume label. 
Each data set is preceded by a header label group and a tapemark, and is 
followed by a tapemark and a trailer label group. The data set trailer labels 
are identified as EOF. Each trailer label group is followed by a tapemark; 
the tailer label group for the last data set on the volume is followed by 

two tapemarks. 





Multiple Data Sets/Multiple Volumes: More than one volume is needed 

to contain the multiple data set aggregate. The last volume is organized 

the same as a multiple data set/single volume layout. On the other 

volumes, the last data set trailer labels are identified as EOV instead of 

EOF, and the last trailer label group is followed by one tapemark instead 
r of two. There is a separate volume label for each tape. 
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IBM Standard Label Processing by Data Management Routines 


Header Labels! | Trailer Labels! 


Processing | 
VOL] | HDRI| HDR2 | UHL1-8/EOF] or |EOF2 or | UTLI-8 
EOVI [EOV2 


First or Only 
Volume: 








Checks labels 
on input 
tope. bypassed | EOV 


Checks exist- 
ing labels on 
output tape 
before over- 
writing. 





Writes new 
labels on out- 
put tope,. 


Second or 
Subsequent 
Volumes : 





Checks labels 
on input tape. bypassed 


labels on out- 
put tape. | or EOV] or EOV 


For read backward operations, the action on header and trailer labels 
is reversed, 

Includes the first volume of concatenated data sets with unlike charac- 
teristics. Data sets with like characteristics can be processed correctly 
using the same data control block (DCB), input/output block (1OB), 
and channel program. Any exception in processing makes the data sets 
unlike. 

Includes the first volume of concatenated data sets with like charac- 
teristics, 

User can create the label with the IEHINITT utility program or a user 
program, Subsequently, the label may be rewritten by the Open and 
EOV routines. 

If DISP=MOD is specified on the DD statement, the Open routine posi- 
tions the tape at the end of the existing data set and allows an input user 
trailer label routine to process user trailer labels (prior to overwriting 
the exsiting labels). 
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Format of IBM Standard Volume Label 


Position (Bytes) Field Number and Name 





1. Label Identifier ] 
‘ VOLI 





3. Volume Serial Number 








et | eet | et 

N|—) oO 
—, 
— 
pened 


4, Reserved 


3. VTOC Pointer 
(Direct Access Only) 





6. Reserved 


7. Reserved 








8. Owner Name and Address Code 


faa 
a 
a4 
ay 
i 
i 
a 
= 
= 
i 
om 
= 
-~_ 
rd 
el 
EL 
ie 
— 
= 
pee 
i 
ea 
_ 
= 
ae 
el 





| 80 | (29) J 9. Reserved 
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Format of IBM Standard Data Set Label 2 


Position (Bytes) Field Number and Name 








1. Label Identifier 
{HoRz/eov2/Eor2 

2. Label Number 

3. Record Format 


4. Block Length 





-_— 
n 
~~ 


5. Record Length 


— 
1S.) 


6. Tape Density 
7. Data Set Position 


8. Job/Job Step Identification 


9. Tape Recording Technique 


10. Printer Control Characters 
11, Reserved 
12, Block Attribute 


(41) 13. Reserved 
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Format of User Label 
Position (Bytes) Field Number and Name 


1. Label Identifier 


4 2. Label Number 
| 5 | 








UHL1-8/UTL1-8 





3. User Specified 
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Volume Organization with ANSI Standard Labels 


Single Data Set Single Data Set 
Single Volume Multiple Volumes 





Volume Label 


Data Set Header 
| 





Labels 


User Header 
Labels 








Data Set Trailer 
Labels 


. User Trailer Labels — 


End of Data Set 


Single Data Set/Single Volume: The volume label is followed by the data 
set header labels and optional user header labels, The data set is preceded and 
and followed by a tapemark. The data set trailer labels are identified as 
EOF and followed by optional user trailer labels. Two tapemarks follow 
the trailer label group to indicate that the data set is the last data set on 
the volume and is not continued on another volume. 





Single Data Set/Multiple Volumes: More than one volume is needed to 
contain the data set. The last volume is organized the same as a single 
volume. On the other volumes, the data set trailer labels are identified 
as EOV instead of EOF, and the trailer label group is followed by two 
tapemarks. The data set and user labels are repeated on each volume, 
and there is a separate volume label for each tape. 
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Volume Organization with ANSI Standard Labels (con't) 


Multiple Data Sets 
Multiple Volumes 


Multiple Data Sets 














Single Volume 


HDRI1 
HDR2 


UHL 
ORE A 











Vol 1 of 3 





Vol 2 of 3 





Vol 3 of 3 








oe fee ee Se 
rt __ SS 

Last of 
Data Set A Data Set B 





UHL 
T™M 


Data Set B 


i 


Data Set A 
oe 







Data Set B 


Continued 








(eae iat ence 
ea een Tan ee 
eae eee, 
ee 





UHL 
™M 


Data Set C 





UTL 


™ 


| 
| TM | 
oe 


Multiple Data Sets/Single Volume: The tape begins with a volume label. 
Each data set is preceded by a header label group and a tapemark, and is 
followed by a tapemark and a trailer label group. The data set trailer 
labels are identified as EOF. Each trailer label group is followed by 

a tapemark; the trailer label group for the last data set on the volume is 
followed by two tapemarks. 


Multiple Data Sets/Multiple Volumes: More than one volume is needed 
to contain the multiple data set aggregate. The last volume is organized 
the same as a multiple data set/single volume layout. On the other 
volumes, the last data set trailer labels are identified as EOV instead of 
EOF, and the last trailer label group is followed by two tapemarks. There 


is a separate volume label for each tape. 
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ANSI Standard Label Processing by Data Management Routines 
Tratler ese euigilerbabelst —_| 


Processing ; OF] 
HDR3-9 | UHL or UTL 
FOVI EOV? 













Ignored 


Ignored 


written | or 





ignored |EOV |bypassed] ignored ignored | EOV 








ignored 










not 
written 


not 
written 












written | or 








For read backward operations, the actian on header and trailer labels is reversed. 
2. Includes the first volume of concatenated data sets with unlike characteristics. (Data sets 
with like characteristics can be processed correctly using the same data control block 
(DCB), input/output block (IOB), and channel program. Any exception in processing 
makes the data sets unlike.) 
3. Includes the first volume of concatenated data sets with like characteristics. 
4, User creates the label with the IEHINITT utility program or a user program. 
5. If DISP=MOD is specified on the DD statement, the Open routine positions the tope at 
the end of the existing data set and allows an input user trailer label routine to process 
user trailer label routine to process user trailer labels (before overwriting the existing labels )+ 
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Format of ANSI Standard Volume Label 


Position Field Number and Name 


(Bytes) 







1. Label Identifier 


4 2. Label Number 





VOL ] 


3. Volume Serial Number 





4, Accessibility 


5. Reserved 





6. Reserved 


7. Owner Identification 





*-ANSI Field Differs 
from Corresponding 
IBM Field 





8. Reserved 


9. Label Standard Level 
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Format of ANSI Header 1 and Trailer 1 Labels 
Position — (Bytes) Field Number and Name 


1. Label igeatlery 
*HDRI/EOVI/EOF1 
2. Label Number 





3. File Identifier 





4, Set Identifier 


5. File Section Number 








6. File Sequence Number 


7. Generation Number 


8. Version Number 


9. Creation Date 


10, Expiration Date 


11. Accessibility 





12. Block Count 





13, System Code *-ANSI Field Differs 
From Corresponding 
IBM Field 


14, Reserved 
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Format of ANSI Header 2 and Trailer 2 Labels 


Position (Bytes) Field Number and Name 








1. Label Identifier 
HDR2/EOV2/EOF2 





2. Label Number 
3, Record Format 





4. Block Length 








5. Record Length 








6. Reserved for Operating System 








7. Buffer Offset 





*-ANSI Field Differs 
from Corresponding 
IBM Field 


8. Reserved for Operating System 
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a a 


Format of ANSI User Labels 


Position (Bytes) Field Number and Name 


1. Label Identifier UHL/UTL 





2. Label number 





3. User Specified 
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Component Support of Label Processing Features 


Linkage) Sort/ = = COBOL... | 
Assembler | Editor | Merge | Utilities] ALGOL | E | ANS v2 J ANS V3 | FORTRAN PL/I |RPG 
ment Facilities for 


Label Processing SSSRSABRras 
Supports Standard 
Labels (SL,AL) Yes ee Wee ace Yes Yes |Yes 


Supports Standard 
User Labels (SUL, 
AUL) No No Yes No | SUL~Yes | SUL-Yes No No 
=a AUL-Yes 

Supports Nonstand= 
ord Labels (NSL)! Yes | Yes 
Supports Unlabeled 

Tape (NL) Yes Yes Fame | vee |v a 
Supports Byposs 

Yes | Yes 


Label Processing 


Option (BLP)? 

INSL con be specified only when installatian-written routines that write and process the nonstandard labels hove 
been incorporated into the operating system. 
2 if the BLP option is not specified at system generation, ifs use defaults to NL, 


















Uses Data Manage- 









































Supports Concaten- 
ated Doto Sets 
with Unlike 
Attributes 
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Section 5: OS/VS JCL, Operator Commands, SMF, RES, and CRJE 





JCL 5-3 

VSI Operator Commands 5-9 
VS2 Operator Commands 5-12 
SMF 5-16. 

RES Operator Commands 5-17 
RES Workstation Commands 5-20 
CRJE Macros and Commands 5-23 


Source Publications 


Additional JCL reference information is contained in OS/VS JCL 
Reference, GC28-0618. 





Additional operator commands information can be found in 
Operator’s Library: OS/VS1 Reference, GC38-0110 or Operator’s 
Library: OS/VS2 Reference, GC38-0210. 


Additional SMF information is contained in OS/VS System 
Management Facility (SMF), GC35-0004. 


Additional RES information is contained in Operator’s Library: 
OS/VS1 RES, GC38-0330, and OS/VS1 RES Workstation User’s 
Guide, GC28-6879. 


Additional CRJE information is contained in OS/MFT, OS/MVT, 
and OS/VS1 CRJE System Programmer’s Guide, GC30-2016. 
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PLEASE COMMENT 


Use Reader’s Comment Form 
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Job Statement 


The JOB Statement 





//jobname 





Positional parameter. 
Keyword parameter. 
Choose one. 





Operands 


([account number][, additional accounting information, ...]) 


[programmer's name] 


Apprspc= }VIRT 
REAL 


[CLASS=jobclass] 


[COND=((code, operator),...)] 


[MSGCLASS=output class] 


scuevan || i) | 


[NOTIFY=user identification ]2 
[PRTY=priority] 

R 

RNC 

NC 

NR 


[REGION=valueK] 


estar stepname [, ea 


stepname. procstepname 


TIME= \ (minutes, seconds) 
/ 1440 


TYPERUN= JHOLD | 
SCANT | 


7 


Optional; if more than one line is enclosed, choose one or none. 


For OS/VS1 only. 
For OS/VS2 only. 





Comments 


Can be made manda- 
tory 


Can be made manda~ 
tory 


Requests storage type 


Assigns A~O 


Specifies a maximum 
of 8 tests 


Assigns A-Z, 0-9 


For TSO only 


Assigns 0-13 


Restart definition 


Specifies amount of 
storage space 


For deferred restart 


Assigns job CPU 
time limit 


Holds a job in job 
queue, or, for OS/ 
VS1 only, scans 
JCL for syntax errors 
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EXEC Statement 








//{stepname] 


The EXEC Statement 


Operation Operands 








Comments 








EXEC § program name 
PGM=4 *.stepname.ddname 


* ,stepname. procstepname. ddname } 


























identifies program or 
cataloged procedure 











{PROC=]procedure name \ 
ACCT=(accounting information,...) Accounting information 
ACCT. procstepname=( accounting information, ...) for step 
[ADDRSPC= VIRT Requests storage type 
! } REAL q ge typ 
r( code, operator) 
COND=(| (code, operator, stepname) peels il Specifies a maximum of 
(code, operator, stepname. procstepname) 8 tests, or 7 tests if 
EVEN or ONLY is 
coded 
(code, operator) 
COND. procstepname=( | (code, operator, stepname) Specifies a maximum of 
(code, operator, stepname. procstepname) 8 tests, or 7 tests if 
EVEN or ONLY is 
coded 
,]} EVEN |) 
ONLY 
[DPRTY=(valuel, value2)]2 Specifies a dispatching 
priority for a job step 
PARM=value Parentheses or apostrophes 
PARM. procstepname=value enclosing value may be 
required 
R \ 
RD=)RNC Restart definition 
NC 
NR. 
R ) 
RD. procstepname= } RNC 
Nc ( 
NR ? a| 
[REGION=valueK | Specifies amount of 
storage space 
TIME= (minutes, seconds) | Assigns step CPU 
1440 { time limit 
TIME. procstepname= \ (minutes, seconds) 
41440 7 
= 








Legend; 


nN TR OU 
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Positional parameter. 

Keyword parameter. 

Choose one. 

Optional; if more than one line is enclosed, choose one or none. 
For OS/VS1 only. 

For OS/VS2 only. 
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DD Statement 


The DD Statement 














P/K 


Comments 





























Defines data set in the 


Bypasses I/O operations 
on a data set (BSAM 


Requests channel 


For use with the SYSOUT 


Completes the data 


Postpones the definition 


Specifies remote destin- 
ation for output data set 


Assigns a status, dis- 
position, and condi- 
tional disposition to the 


Assigns delimiter other 


Assigns a name to a new 
data set or to identify on 
existing data set. An 
unqualified name is 1-8 
characters, beginning 
with an alphabetic or 
national character, 


Specifies forms control 
information. The FCB 
parameter is ignored if 
the data set is not written 
to a 3211 printer. 


//Name Operation Operands 
//| ddname oD i 
precsteprone | DATA[, DLM=xx) P 
ddname input stream 
[DUMMY] P 
and QSAM) 
[DYNAM]2 P 
{AFF=ddname] K 
separation 
[COPIES=nnn] K 
parameter 
DCB=(list of attributes) K 
‘ddname control block 
DCB=( scenane [, list of attributes]) 
.stepname.ddname 
\* ,stepname.procstepname. ddname 
[DDNAME=ddname K 
of a data set 
[DEST=userid]' K 
, DELETE 
NEW , KEEP , DELETE 
DISP=(| OLD , PASS , KEEP ) K 
SHR ,CATLG ,CATLG 
MOD ,UNCATLG ,~UNCATLG 
; data set 
| [DLM=delimiter] K 
than */ 
| dsname 
dsname(member name) K 
dsname(generation number) 
dsname(area name) 
Sos NAME’ =] &&dsname 
DSN &&dsname(member name) 
&&dsname(area name) 
* ,ddname 
*  stepname.ddname 
* ,stepname. procstepname. ddname 
: : ,ALIGN K 
FCB=(image-id , VERIFY ) 
K 


Yes; |! 
| HOLD nO | 





Specifies whether output 
processing is to be de- 
ferred or processed 
normally 
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DD Statement (con’t) 


The DD Statement (con't) 















































// Name Operation Operands | P/K Comments 
i 
// [ddname “| DD j SL | 
prcseprome (con't) ,SUL 
ddname AL , PASSWORD E IN 1 
,AUL | | , NOPWREAD | | ,OUT 
LABEL=([data set seq #]/ , NSL ; K Supplies label 
~NL | | information 
, BLP 
,LTM 
‘ 
[ ExPDI=yyddd |] ) 
{| RETPD nann |} | 
[OUTLIM=number]}] K Limits the number of 
logical records you 
want included in the 
output data set 
(QNAME=process name | K Specifies the name of 
a TPROCESS macro 
which defines a 
| destination queve for 
messages received by 
means of TCAM 
[SEP=(ddname,...)]' K Requests channel separa- 
tion 
(/ \ TRK | ) 7 
Is PACE=( CYL , (primary f secondary | | ,directory |) K | Assigns space ona 
|] blockteag iF | ins direct access volume 
, | | for a new data set 
, CONTIG | 
(egal »MXIG iy ROUND]) 
P ,ALX 
: | 
25PACE=(ABSTR, (primary quantity ,address| ,directory | )) K Assigns specific tracks 
e Bas | 7 on a direct access 
volume for a new data 
set 
aces (primary quantity |,secondary quantity | )) / K Assigns space on a 
SPLIT= Ja direct access volume 
PES Y oer cenaroaes ee quantity | , secondary aeRO for a new data set. 
percent Data sets share cylinders 
\ ERK 
SUBALLOC=(« CYL , (primary pee |, directory]) | K Requests part of the 
| blocklength | ; | | space on a direct 
access volume assigned 
| ,ddname | | | earlier in the job 
¢ ,Stepname.ddname ) | 
| | ,stepname. procstepname.ddname | 
Pecunia Eceroaran ae [, form number]), | K Routes a data set 
1 le through the output 
stream. For classname, 
[OUTLIM=number]} assign A-Z or 0-9 
[TERM=RT} } | K indicates that on RTAM 
| device is in use 
= — ss a 
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DD Statement (con't) 


The DD Statement (con’t) 





//Name Operation Comments 


¢ . (continued from [TERM=TS] 2 identifies TSO user 


previous page) 








character set for a 


Seige set eel ores | pie Requests a special 
1403 printer 


’ 





unit address ,unit si : 
unite device ve ,P [, DEFER] |, SEP=(ddname, ...)]) Provides the system 


group name ] L., J with unit information 


] 





- UNIT=AFT=ddname 


ag a ee] ec a) Provides the system 


VOL with volume information 


r ? 


SER=(serial number,... 
REF=dsnome 


C [, volume count] [, ]] REF=*.ddname 
REF=* ,stepname, ddname 


REF=* ,stepname. procstepname .ddname 








Legend: 

Positional parameter. 

Keyboard parameter. 

Choose one. 

Enclosing subparameter, indicates that subparameter is optional; if more than one line is enclosed, choose one or more. 
Enclosing entire parameter, indicates that parameter may be optional, depending on what type of data set you are defining. 
For OS/VS1 only. 

For OS/VS2 only. 


NRO mK 
ee 
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Comment - Delimiter - Null - PEND - PROC Statements 





Operations 








Comments coded in free form. If all comments cannot be included 


on one statement, they can be continued on consecutive comment 
statements. 


The Delimiter Statement 


Operations 








/* or any Comments coded in free form. If all comments cannot be included on 
two charac- | one statement, they can be continued on consecutive comment 


ters de- statements. 
fined by 
the DLM 


parameter. 





The Null Statement 


Operations 





Blanks. The null statement placed at the end of job control state- 
ments and data indicates that the job is to be put on the queue of 
jobs ready for processing. 





The PEND Statement 


//name Comments coded in free form, If all 

(up to 8 characters followed comments cannot be included on one 

by one or more blanks) statement, they can be continued on 
consecutive comment statements. 





The PROC Statement 


//name Symbolic parameters and their correspond- 
(up to 8 characters followed ing default values, separated by commas: 

by one or more blanks) 
symbolic parm = val, symbolic parm = val 





In a catalogued procedure, the operand 
field is not optional. 





In an in-stream procedure, the operand 
field is optional. 
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VS1 Operator Command Outlines 


, DUMPI,ALL] 
jobname| ,IN a | 
HOLD. 


,OUT=I[s 
wae ae ler 
C 


unitaddr 
redaaaek iy 
[procname .] identifier 


. {per ine ce 
PARM= eats 


7 TP 
,GRAPHIC] |, ONLINE | [, cuu] Z, nnn] 
, TAPE OFFLINE 
,DASD 
arcane: ,UR 


R 

Q [= qclass] 

N [= qclass] 
jobname[, HOLD] 
CONSOLES 
SQA 


ia 
Zz 


{ ea eal \ 


(ernie 


‘ete ‘text! 
L 
STATUS 
— RETRY fee 
walk QUIET 
MODE ee 
QUIET 
CONTROL Te SHOte) 
QUIET 


{eee [, CLASS = outclass] 

[procname.](Pnn (CLASS = bela] 

ae Yee unitaddr [, ‘text '] 
f aio | ype Pitoncuc tana aaa 

DATASET [, OUTCLASS =s] 
JOBNAMES[, T] 
MONITOR bee 
MN SPACE 

STATUS 


(NL, volserial) STORAGE 
rae sitar, VOL} (SL veer | se= PUBLIC 1 
M (AL, volserial) PRIVATE 
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VS1 Operator Command Outlines (con’t) 


Pome [med 


Ce ..)[,MN=AIL, 





see (display ~ operand, . 
Sree 


RE as Ni frinel 
A aa 
RE R | ‘text! 
R text 


RESET jobname, \PRTY =nn ([, OUT=s] 
CLASS=c 















DATE = yy ,ddd[CLOCK =hh.mm.ss] 


identifier, unitaddr 
procname | .< Pnn ,| /devicetypel |,},volserial|, 





















ALL 


jobname 

outclass 

jobclass 

(jobclass, RESV = nn) 
pe (RESV =nn) 

(JOBCLASS =class, OUTCLASS =s) 
(parm) 
([MODE =( INT [, TIME = YES][, DEBUG = YES][, BUF = nnn]) 
an, 

EXT 


[, keyword =option,...]* 
* The keyword =option parameter(s) can follow after the 
last positional parameter. 


[procname] (, identifier 
7Pnn 


unitaddr 
jobname 
JOBNAMES 
DSNAME 
SPACE 
STATUS 


the 











oe 
DSNAME 
ae 
OFF 
Poy [Bhd 
unitaddr, cuu 
cata SMF 


pe 


“ONLINE ee % 

ARY unitaddr OFFLINE ae 
\V. (unitaddr, unitaddr...)\ ),PATH,cuu, JONLINE 
| OFFLINE 
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VS1 Operator Command Outlines (con't) 


ail eae unitaddr y MSTCONS 
> Vv Nf ocuG. Owes) 


unitaddr ),HARDCPY| (, CMDS 

1eystOC] , NOCMDS 
, OFF 
/INCMDS 
, STCMDS 


ALL 
[rour=}NoNe 
(routecode|, routecode]. . .) 


unitaddr ,unitaddr 
(Ome t}:O- ew coe 
(l- cuu,O=cuu)) LC, (l- cuu, O= cuu) 
,ONLINE 
‘ OFFLINE 
4 ALL 
eae /AuTH=| INFO 
¥ (ISYS]| 10} ,CONS]) 
ALL 
,CONSOLE jrout=| NONE 
(routecode|, routecodel...) 
unitaddr 
/ALICONS= | =e 
(l= cuu, O= cuv) 


ais en 
DS 
nan 
osPa|0s 
WRITER unitaddr, JOB |, JBN = jobname] 
{ WTR \ pues 
Cc 
HOLD 
palais ya 
nnn 





Section 5: OS/VS JCL,SMF,andCRJE 5-11 


i 





VS2 Operator Command Outlines 


identifier 
devicetype 
unitaddr 
devicename 














CANCEL 
{ Cc } [, DUMP] [, ALL] 
jobname | ,IN[=i] 
, OUTI=s] 

rTP 
GRAPHIC | [OFFLINE 
, TAPE cera [,cuu] [,nnn 
,DASD 

{DISPLAY } UR 

D 


CONSOLES 
jobname 

R 

Ql[=qclass] 
N[=qclass] 


c,K 
DUMP COMM=(comment) 





a, 
— 
N > 
rr 
ond 
Satta cotta” 


era { Ql|Finclass] \ 


jobname 


—_— 
rm 
-O 
a 
ae 


STATUS 


RETRY[, | peat \ 


QUIET 


MODE MAINI, i or 





CONTROL, ]{ THRESHOLD} 


jobname, parm 


, CLAS S=jobclass 
[procname. identifier }, CLASS=outclass 
{ MODIFY \ 


F 


, PAUSE= { FORMS \ 


DATASET 


JOBNAMES|[, T] 


{MONITOR ee 


STATUS 


= 
Z 
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VS2 Operator Command Outlines (con’t) 


unitaddr 


, VOL=(SL, serial) STORAGE 
,VOL=(AL, serial) >| ,USE= < PUBLIC 
,VOL=(NL, serial} PRIVATE 


devicename 





i a vie) b= {ee ] 


cca 


RELEASE oer 
A jobname 
id, ["Itext["] 













PLY U 

R STOR=(startaddr, endaddr,...}[, SDATA] 
(used for SDATA 

DUMP) 














,PRTY=nn 
wrk iobname 2 , CLASS=c [, OUT=s] 
, PRTY=nn, CLASS=c 


a DATE=yy .ddd[, CLOCK=hh mm. ss] 










eas procname[. identifier] [, cuu] [, volumeserial] [, parmvalue] 
S [,jobname] [, LSQA=nn] [, keyword=option,...] 
deuetiel (cual; lvolamaseriall Ii | Move: aN {| 
ee (INT,S) 
GTFSNP 
2 __ YES _ (ves _ 
[,BUF=nnn] [, TIME YES {| besuc- vest | ] [, REG=nnn] 
STOP } [procname. lidentifier 
P | jobname 





mone 








JOBNAMES 
DSNAME 
SPACE 
STATUS 













unitaddr ,unitaddr 
( | ons eae {2 
(l-cuu, O-cuu) , (l-cuu, O-cuu) 


ALL 
, AUTH= {inFo 
(ISYS][,1Q][, CONS] ) 





ALL 
,CONSOLE | ,ROUT# NONE 
(routecode[, routecode]...) 
unitaddr 
, ALTCONS= | oan 


(l-cuu, O-cuv) 
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VS2 Operator Command Outlines (con’t) 









,ONLINE 
unitaddr l , OFFLINE 
} (unitaddr,unitaddr...)| ),PATH,cuu, ONLINE 
tC aR \ 
{unitaddr ,MSTCONS 
} (l-cuu, O-cuu) 










unitaddr | , HARDCPY , CMDS 
SYSLOG , NOCMDS 
, OFF 
, INCMDS 
\ , STCMDS 
ALL 
,ROUT= < NONE 
(routecode|[, routecode].. 
penne 
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Definitions of Substitutional Operands 







a 


an area on a graphics console. 





¢ 








one input (A-O) or output (A-Z,0~9) class. 










cc 


class 


console identification number. 





one to fifteen job classes (A-O) without priorities. 








comment 





a 1-100 character identifier. 









cuu 


the channel and unit address (cuu) on an I/O device. 





devicename 






devicetype 





a device that was specified, such as 231401 or 231400. 





a unit type, such as 2540 or 1403, of the output device to be used. 









eeec 


a four digit decimal number indicating an error count. 





hh .mm.ss 








idd 


identifier 





a single input class. 





a two digit identifier that is identical to the identifier included in the 
system message. 


a three digit identification number of the status display . 





a unique one to eight character alphanumeric name that starts with a 
letter and identifies one task started by a cataloged procedure. 





inclass 





one to four input queve classes. 





l-cuu, O-cuu 





jobclass 


jobname 


keyword =option 





outclass 


the channel and unit addresses (cuu) of the input (Il-cuu) and output 
(O-cuu) devices that make up a composite console. 





one to fifteen job classes (A-O). Priority of processing is from left 
to right. 


the name of a specific problem program that appears on the JOB 
statement. 





any valid keyword/option combination that may appear on a DD 
statement. 





a single digit decimal number. 





a two digit number from 00 to 03. 








a one to three digit decimal number. 





one to eight output classes (A-Z,0-9). 








O-cuu 








Pan 















the channel and unit address (cuu) of an output only console. 






information, of variable format, to be passed to a problem program. 








a partition number (POO-P15). 











procname 












the name of a cataloged procedure that resides on SYST .PROCLIB. 


one to four queue classes (A-O for input queues, SOUT for the output 
queve, HOLD for the hold queue). 










routecode 





tttt 








unittaddr 
volserial 
x 


yy -ddd 


a system-to-operator message routing code. 











a single output class (A-Z,0-9). 





information of extremely variable format. 





a four digit decimal number indicating an hour limit. 











the channel and unit address (cuu) of an 1/O device. 


the volume serial number of a disk pack or magnetic tape. 
a recording mode: either R (record) or Q (quiet). 


the year (60-99) and Julian day (000-366). 
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SMF 


SMF 
SMFDEFLT parameters 


ae i} 1- collect system & job info 
2 2- collect system, job, & job step info 





DSV=; 0 0-no data set or DASD info 
1 1- collect DASD info 

2 2- collect data set info 
3 


3- collect data set & DASD info 


REC= {+ 0-no temporary data set info 
2 2-collect temporary data set info 





EXT= ses} NO-no exits 
YES YES-= take exits 


JWT=nnn nnn= wait state time limit in minutes 


[ BUF=nnnnn] nnnnn- buffer size in bytes (max for VS1 is 2048, 
for VS2 is 8192) 


SID = xx xx= system type 





MDL=nn nn- user system identification 


de NPS YES - operator allowed to modify parameters 
NO. NO = operator not allowed to modify parameters 


USER 
ALL 


baie tie ser no \ vol= volume serial number of SMF volume 
(,dev addr) 


USER=only user records to SMF data set (type 128255) 
ALL-=all record types to SMF data set 


dev-device address of SMF volume (cuu) 


\ | user {| NONE-= no records to SMF data set 


os vol ser no vol = volume serial number of alternate volume 


(,dev addr) dev-device address of alternate volume 
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RES Central Operator Commands 


Operator commands that require no modification for RES. These commands are not 


valid from RES workstation, 


CONTROL 
DEFINE 
DUMP 
HALT 
LOG 
MODE 


SET 

SWAP 
SWITCH 
UNLOAD 
VARY 
WRITELOG 


Operator commands that use additional operands for RES. 


CANCEL 
DISPLAY 
HOLD 
MODIFY 
MONITOR 
RELEASE 


*Command not valid from workstation. 


New operator commands for RES. 


LISTBC 
LOGON 
LOGOFF 


Section 5: OS/VS JCL, SMF, and CRJE 


REPLY 
RESET 
START* 
STOP 
STOPMN 
WRITER 
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RES Central Operator Command Outline 


Operation 





ne a 


CANCEL 
Cc 


pe | 


aaa 


HOLD 
H 
a dlaat 
LB 
| LOGON 


LOGOFF 


rc 


RELEASE 





| 


ea 
MN 


A 





REPLY 
R 


| 
| 


Operand 


[, DUMP] [, ALL] [, USER=userid] 
,IN[Finclass|HOLD] 


[JBN=]jobname 
, OUT [=outclass| HOLD] 


| 


{[DEV=lid 
unitaddr 


t USER=userid] 
devicetype 


jobname[, HOLD] 
,ALLQ 


Bee | 
Ziti 


=userid 
‘ 


I, L] 
T 


=term-id 
=nnn.aam[,nnn.aam,...] 


| 


[NOTICES] [, MAI|L=userid] 


Q[Faqlist] 
N[-qlist] 


USER E 


el 


USER=useri 
ALL 


| 


Scere {, USER=userid] 
[=list] 


ALL 
ACT 
INAC 


TERM 





CENTRAL [/password] [PROC (procname)] 


CENTRAL 
userid 





START 
STOP 
RESTART 


[procname. ], = 


SESS[, 


j sirens eee 
(=list] 


[R]lmsgno, 'text' 


jobname[, PRTY=pp] [, CLASS=class} [, OUT=outclass] 
, USER=userid 
JBN=jobname[, USER=userid] 


ALL, USER=userid [,CLASS=outclass] 


JBN=jobname 


ALL GROUP, USER-veral 


[, DEST=userid] | , HOLD= vest 
NO\ 
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RES Central Operator Command Outline (con’t) 


ae SAVE 






LOGON 


messageno LIST 
, DELETE 


ALL ,NOW ~ 
"text' |, USER=(userid,...) ,LOGON 
, OPERATOR=route=code| | , SAVE 
















procname|[, id] 






wr 


a [id], USER=userid 






V cmmmtiioaae 











_. {blank 
[procname. jid ; on 


STOPMN SESS 














{wren | 
| WTR LSP \¢ [, JBN=jobname] [, USER=userid] 


HOLD 


_ fnnn 
REPEAT= (im 03} 
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RES Workstation Operator Command Outline 


ane [, DUMP] [, ALL] 
Cc 










[JBN=] jobname { , IN {inclass|] HOLD}] 
, OUT [={outclass | HOLD }] 


[DEV=] id 





T 
R 
jobname[, HOLD] 
Q[Eqlist] 
N [=qlist] 


7L 
Hone : ee | 


{ HOLD 
} H jobname 


DISPLAY 
D 














{ LISTBC NOTICES[, MAIL] 
1 6B MAIL[, NOTICES] 
} a "text! 
LOGOFF 
LOGON userid [/password] TERM(term-id) 
[PROC(procname) | 
NOTICES MAIL 
NONOTICES NOMAIL 
MODIFY [procname. Jid[, CLASS=list] [, PAUSE= }FORMS 
F DATASET 


procname. Pnn, ‘data' 








MONITOR 
MN JOBNAMES[, T] 
} RELEASE 
A jobname 





BLANK 
a LY msgno | ext 
, text 


tob , PRTY=pp[, CLASS=outclass} 
Jobname J ,CLASS=outelass[, PRTY=pp] 





[, OUT=outclass] 








JBN=jobname[, GROUP=list] 
ROUTE ALL[, GROUP=list] 
RO GROUP=list 
[, CLASS=outclass] [, DEST=userid] 
[, HOLD=(YES|No)] 


NOW 
oe "text'| , USER=(userid[, userid]. aE LOGON 
SE SAVE 


, OPERATOR=route-code 
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RES Workstation Operator Command Outline (con't) 


ie 
STOPMN JOBNAMES 


,HOLD 
, FSP= {DS | nfs} 
.. < , BSP= {DS | JOB | nbs} 
unit} REPEAT= {nnn | (nnn, JOB)} 
,LSP= {n | C) 





















WRITER 
WTR 





[, JBN=jobname] 
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Definition of Substitutional Operands - RES 


class specifies an input or output class. 


specifies information to be passed to the procedure. 





devicetype | specifies a device type (for example, PRI). 


specifies any unique one to eight character name that starts with 





a letter (except for Pnn or ALL). 


inclass specifies an input queve class. 











specifies the name of a specific problem program. 


specifies one to four queue classes, 


one or two character identification of a message reply. 


pn | 1, 2, 3 (single space, double space, or triple space). 
specifies a single digit decimal number, or a list of numbers. 





| mmm specifies a decimal digit from 1 to 255, 


nnn specifies a workstation (1-200), aa identifies a device type 
(RD, PR, PU), m identifies a particular device. 


specifies a decimal digit from 1 to 100 (indicates the number of 
pages to be backspaced). 





nfs specifies a decimal digit from 1 to 255 (indicates the number of 
pages to be spaced forward). 


outclass specifies an output class. 
password specifies an assigned sequence of one to eight alphameric 
characters. 


Lali electrical 
started. 

| spa 
specifies the name of a cataloged procedure. Ly 
specifies one to four queue classes (A-O for input queues, SOUT ae? 

for the output queve, HOLD for the hold queue). 

| term=id | specifies a unique number (1-200) assigned to a workstation, : 
| estan nine am 


userid specifies an assigned sequence of one to seven alphameric characters. 





Be 


wtr specifies the name of a writer procedure being started. 


5-22 OS/VS Programmer’s Reference Digest 











CRJE Macros 


[nome]] CRJELINE | DDLINE=ddname, DDSYSIN=ddname ae ‘ia 


,LERB=/ | integerl || ,integer2 ,integer3 ,ingeger4 
25 |)" 10 |" 5 5 


1050, ADDR=char: BCD 
,TYPE= ¢ 2740~1 ,CODE= {CORRES 


2741 EBCD 


[, FEATURE=([DIAL] ,[INTERRUPT])] 


fon 





CRJETABL | JOB=integer, USERS=integer, SYSCRJE=character _ 
[, JOBEXIT=routine name ] [, ONEXIT=routine name | [ ,OFFEXIT=routine 
name | 
,BUFNO= J integer »MSGNOS5 }integer (| | ,BRDCST=) integer 
1 100 109 





lea “orl | MSGRC= ira | 
10 8 


[,ALIAS= (command name, alias,...)] [,USRMCMD=(command,...)] 
[, USRSCMD= (subcommand,...) ][, CMDEXIT=routine name] 


: PLILNO= jeseeer ,FORTLNO= tinteger 
é rs 


[nome]} CRJEUSER| [userid,password,...] 


Section 5: OS/VS JCL,SMF,andCRJE 5-23 





CRJE Terminal Command Formats 
CRJE Terminal Command Formats 


COMMANDS 
1. CANCEL jobname 
HI ERE] 
CONTINUE [sect | 
N [EXT] 
DELETE dsname 
[ NEW) [NUM iene ] 
EDIT dsname LOLD JLNONUMJLNOSICAN] 
PL1 [ (parameters) ] 


E 
FORT {ct 
H 


DSLIST 
CLIST 
DATA 
TEXT 











[ L [IST] | 
EXEC dsname | NOL [IST] 


LISTBC 

LISTDS dsname [SITATUS] ] [H [ISTORY 1] 
LISTLIB [S[TATUS] ] [HIISTORY] ] 
LOGOFF 


LOGON userid/password 
[A [CCT] (accounting information) ] 


[ 2 ] k [SGID] ] 

NOBC NOM I[SGID] 

OUTPUT jobname [SMSG] 

U [SER] (userid) [C [OW] 


LIOGONI] 
SEND 'text' 





O| PERATOR] (integer) 
STATUS [jobname ] 


SUBMIT dsname ... 


TABSET num.ee || INT PUT] 
ofr |{OuTTPUT] 
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Edit Subcommands 


EDIT SUBCOMMANDS 


1. 








linenum [A text ] 
CA [NCEL] jobname 


C [HANGE] linenum [linenum] 
A text! Atext2 A[ A [LL] ] 

D [ELETE] [linenum [linenum] ] 
END 


[ [increment] [1 '] P [ROMPT |] 
| [NPUT] | linenum R NOP TROMPT] 


[ NUM | 
L [IST] [linenum [linenum ] ]L NONUM 


{ shail 
M[ERGE] 7 [linenum linenum] [linenum] 


linenum F increment 
REN[UMBER]| 10 [ 10 ] 


S[AVE] I[dsname] [K [EY] ais 
SCI[AN] — [linenum [linenum] | OFF 


U [SER] (userid) N [OW] ] 
L [LOGON] 
SEND 'text' _O [PERATOR] (integer) 


{ soene | 
SUB[ MIT ] 7 Poe 


TAB [SET] [ num... | [ IN [PUT] 
OFF || OUTTPUT! 
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Session Management Commands 
SESSION MANAGEMENT COMMANDS 


Command Function 
LOGON To identify the user and initiate his session. 
LOGOFF To terminate a session. 


DATA MANAGEMENT COMMANDS 
General 


Command Function 


DELETE To scratch an VS data set or to remove a CRJE data set from the 
user's library. 


EDIT To initiate creating or updating operations. 


EDIT Subcommands 
Subcommand Abbreviation Function 
INPUT | To insert and/or replace lines in the active set. 


DELETE D To remove lines in the active data set. 
Implicit To enter or delete lines in the active data set. 


CHANGE Cc To replace character strings within lines of the 
active data set, 


MERGE M To combine another data set with the active 
data set or to copy lines from one place to 
another within the active data set. 


RENUMBER To reassign line numbers to the lines in the 
active data set. 


LIST To display lines of the active data set. 


SCAN To request a syntax analysis of PL/I or 
FORTRAN source language statements in the 
active data set. 


SAVE To store the active data set in the user's 
library. 


END To terminate creating and updating operations 
and to delete the active data set. 


JOB PROCESSING COMMANDS 


Command Function 


SUBMIT To enter a job into the VS job input stream. (Can also be used 
as an EDIT subcommand; it can be abbreviated SUB when used 
as a subcommand.) 


OUTPUT To request CRJE SYSOUT output of a conversationally - submitted 
job. 
CONTINUE To resume output listing that was previously interrupted. 


CANCEL To remove a job from the CRJE system and to delete any 
CRJE SYSOUT output of that job. (Can be used as an EDIT sub- 


command; it may also be abbreviated CA when used as a sub~ 
command, ) 


STATUS INFORMATION COMMANDS 


Command Function 


LISTLIB To obtain the name and characteristics of every CRJE data set 
in the user's library. 
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Status Information (con't) 


STATUS INFORMATION COMMANDS (cont. ) 


Command Function 


LISTDS To obtain information about a particular CRJE data set in the 
user's library. 


STATUS To obtain information about jobs the user has submitted. 
MESSAGE COMMANDS 
Command Function 


SEND To send a message to the central operator or to another terminal 
user. (Can also be an EDIT subcommand.) 


LISTBC To request the broadcast messages. 


TABSET COMMAND 


Command Function 


TABSET To indicate the tab settings at the terminal. This command 
affects all input and output and can be either a command or an 
EDIT subcommand. (Can only be abbreviated - TAB - as a sub= 
command.) 


EXEC COMMAND 
Command Function 


EXEC To execute a sequence of commands contained in a CRJE data 
set. 


CRJE INSTALLATION VARIABLES 


The following functions, restrictions, and assignments are determined by the 
central installation when the system is generated. 


ADDITIONAL COMMANDS AND SUBCOMMANDS 


The installation may add commands and subcommands to the system by providing 
the routines to process them. 


COMMAND ALIASES 


The installation may assign alternate verbs (aliases) for the CRJE commands and 
subcommands. Duplication of aliases is allowed between modes but not within 

the same mode; j.e., the same alias may be used for a command and a sub- 
command, but it cannot be used for two commands (if in command mode) nor for 
two subcommands (if in edit mode). Either the CRJE name or the installation alias 
is recognized when entered from a terminal. 


EXIT ROUTINES 


Routines may be provided by the installation to check the accounting information 
on LOGON commands, to check JCL’statements of jobs submitted for batch 
processing, and to obtain accounting information when a user logs off the system. 
An installation routine may reject a LOGON command and may terminate a job 
submission. 
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Syntax Checkers 
SYNTAX CHECKERS 


The installation selects what syntax checkers, if any, are provided in the system 
and the kind of checking performed (i.e., level of checking or language level 
supported). 


NUMBER OF LINES PER SYNTAX SCAN 


The installation can impose a limit on the number of lines one statement can 
span and still be scanned as a complete statement by the syntax checker. 


USERID/PASSWORD 
The installation assigns userids and passwords to authorized terminal users. 
CRJE SYSOUT CLASS 


The system output class used for remote job output to be returned to terminal 
users is assigned by the installation. 


NUMBER OF LINES PER OUTPUT GROUP 








The installation specifies how many lines of output are sent to terminal before 
allowing the terminal user to interrupt the output. This only applies to terminals 
without a special interrupt feature. 


MAXIMUM NUMBER OF JOBS 


The maximum number of jobs that can reside in the central system at one time is 
determined by the installation, When this maximum is reached, no more jobs 
are accepted until some of the existing jobs are cancelled or their output is 
returned, 


MAXIMUM NUMBER OF MESSAGES 


The installation determines the number of messages that can be maintained by the 
system at any one time. This includes messages waiting for delivery at logon 
time and messages currently being processed. 


ROUTING CODES FOR MULTIPLE CONSOLES 


If the central system supports multiple consoles, the installation specifies a 
routing code for each console. A user may direct a message to an operator at a 
particular console by specifying the routing code for that console. 


ON=LINE TERMINAL TEST 





The installation determines whether or not the BTAM On-Line Terminal Test 
facility is provided, This facility provides tests that can be used by the terminal 
user as a start-up procedure or by the customer engineer for terminal checkout 
and diagnosis of terminal failure. 
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System Operator Commands for CRJE 


BRDCST nnnn, ‘text’ 
"text! 


nann 


DELETE 


-|CENOUT | C, J=jobname, C=class 


MODIFY [ procname. ] identifier, { D \ = (address, ...) 
F A 


Seana [, \Fuserid [,Q ] \ 















D= userid 


Operation Operands 


SHOW JOBS [, jobname | 
USERS [, userid] 
ACTIVE [, NUMBER] 
BRDCST 
MSGS [, userid | 
LERB [, lineaddress | 
SESS [, userid | 
SESSREL [, userid ] 


stare \ re eo NO ) 
5 





NFMT »),NORM 
NONE 


[ procname, | identifier 









Cy ie [DD] i (userid, password) 
D [ELETE] 
S [UPPRESS | 
R [ESUME ] 
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PLEASE COMMENT 


Use Reader’s Comment Form 
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Section 6: Linkage Editor and Loader 


Linkage Editor 


JCL Statements 6-2 

PARM= Options and Defaults 6-3 
Incompatible Job Step Options 6-5 

Linkage Editor Return Codes 6-5 

Linkage Editor Control Statement Outlines 6-6 
Linkage Editor Record Formats 6-6 

Linkage Editor Capacities 6-7 


Loader 


JCL Statements 6-7 

PARM= Options and Defaults 6-8 

DD Statement Considerations 6-9 

Loader Macro Outlines and Parameters 6-10 
Loader Return Codes 6-11 

Virtual Storage Requirements 6-12 


Source Publication 


Detailed information about the linkage editor and loader is contained 
in OS/VS Linkage Editor and Loader, GC26-3813. 
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Linkage Editor JCL Statements — Optional/Required 


Optional 
See notes. 


6-2 


Required and Optional Statements 
| //jobname JOB 
//stepname ine 


//SYSLIN. DD 


//SYSLIB DD 


//SYSIN DD 
//SYSUT1 DD 
//SYSPRINT DD 


//SYSLMOD DD 
//SYSTERM DD 


//ddname DD 


PBM=HEWL } 


PGM=LINKEDIT 
, PARM= ' options’ 


dataset reference 


dataset reference 


DDNAME= SYSIN 


dataset reference 
dataset reference 


dataset reference 


dataset reference 


dataset reference 


dataset reference 


/Linkage Editor Control Statements 


/ Object Module(s) 
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Notes 


These names can also be 

used: IEWL 
IEWLF440 
IEWLF880 
IEWLF128 

or as a subprogram: 
LOAD/CALL 
LINK 
XCTL 

or as a subtask: 
ATTACH 


Primary input data set: 

*=for an immediately 
following data set. 

DSNAME =data set. 
DISP=(OLD, 
DELETE) for a 
cataloged data set 


For automatic call: 
DSNAME= library, 
DISP=SHR 
libraries are; 
SYST.ALGLIB 
SYS1.COBLIB 
SYS] .FORTLIB 
SYST. PLILIB 
SYS1.SORTLIB 


Reference to linkage 
editor control statements 
if not included with 
SYSLIN data 


intermediate data set 


Diagnostic output data 
set 
Output module library 


Required only if PARM= 
TERM specified on EXEC 
statement 

One for each INCLUDE 
or LIBRARY reference 

In addition to or if not 
defined as a data set by 
the //SYSIN DD state- 
ment 


In addition to or if not 
defined as a data set by 
the //SYSLIN DD state- 


ment 


End of linkage editor 
input and job step. 


End of job 











Linkage Editor Execute Statement 


Execute Statement: 


PARM=" options’ 
options are: 


HIAR 


SCTR 
DC 
NE 
OL 


OVLY 


RENT 
REUS 


REFR 
TEST 


XCAL 
LET 


NCAL 


ALIGN2 


SIZE= 
(value}, 
value?) 


DCBS 
LIST 
MAP 


XREF 


TERM 


t 


hierarchy format; may be specified, but ignored as unsupported 
by OS/VS1. 

scatter loading; may be specified, but ignored as unsupported 
by OSNVS1. 

downward compatable; only needed when max record size re- 
quired or grouping of output load module CSECTs not desired. 


not editable; no ESD produced in load module. NE is ignored 
if MAP or XREF specified. 


only load; a LOAD and branch instruction or CALL required 
to load and enter module. 


overlay; must be present if OVERLAY or INSERT statements 
are used. Not for use with refreshable, re-enterable, or 
serially reusable programs. 

re-enterable; all CSECTs must be re-enterable or RENT is 
ignored, 

reusable; all CSECTs must be re~enterable or serially reusable 
or REUS is ignored. 


refreshable; all CSECT must be refreshable or REFER is ignored. 


test; for TESTRAN or the TSO test command. Modules using 
TESTRAN should not be marked RENT, REUS, or REFR. 


exclusive call; must be specified with OVLY. 


allow execution; execution of the module may be attempted 
even if severity 2 errors have occurred during linkage editing. 


no automatic library call; library members are not called to 
resolve external references. A SYSLIB DD statement need not 
be supplied. 


align on page boundary; used with PAGE or ORDER with P 
operand statements to cause alignment of CSECTs on 2K page 
boundary. Default is 4K alignment. 


size; value] is virtual storage available for linkage editor with 
minimum of 65,536 and default of 196,608. Value? is load 
module buffer with minimum of 6144, maximum of 102,400, 
and default of 65,536. 


allow specification of DCB for SYSLMOD = block size must be 
specified in DCB parameter of SYSLMOD DD statement. 


list linkage editor control statements; statements appear in 
card~image format on diagnostic output data set. 


map the output module; the map appears on the diagnostic out- 
put data set. 


produce cross reference table; cross reference table, including 
map, appear on diagnostic output data set. Map cannot be 
used with XREF. 

print diagnostics on data set specified by SYSTERM DD 
statement; if SYSTERM DD statement is not included, TERM 

is ignored, 
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Linkage Editor Execute Statement (con’t) 
PARM default attributes for the linkage editor: 


not overlay 

not tested 

block format 

not refreshable 

not re-enterable 
not serially reusable 





Execute Statement: 


REGION parameter 





REGION=value - if SIZE= was specified in PARM, REGION value must 
at least value , +8K. 
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Linkage Editor Incompatible Job Steps/Return Codes 











lea » 
Se AN Fe Ha ae J Sm De 


Incompatible Job Step Options for the Linkage Editor 


Linkage Editor Return Codes 


Return everity 
Code Code Description 
| 00 | 0 | Normolconciione 


04 Warning messages have been listed, execution should be 
successful, For example, if the overlay option is specified 


1 
and the overlay structure contains only one segment, a return 
code of 04 is issued, ; 
8 2 






















Error messages have been listed, execution may fail, The 
module is marked not executable unless the LET option is 
specified. For example, if the block size of a specified 
library data set cannot be handled by the linkage editor, a 
return code of 08 is issued. 


















Severe errors have occurred, execution is impossible, For 
example, if an invalid entry point has been specified, a 
return code of 12 is issued. 





Terminal errors have occurred, the processing has terminated, 
For example, if the level F linkage editor cannot handle the 
blocking factor requested for SYSPRINT, a return code of 16 
is issued. 
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Linkage Editor Control Statements 


symbol ,symbol 
external name , external name 


external symbol(newsymbol) [, external symbol(newsymbol), .. 

























a 


CHANGE 
ENTRY 





externalname 








IDENTIFY 
INCLUDE 


csectname(‘data')[ ,csectname(‘data')]... 

















ddname[(membername[, membername ]...)] 
[,ddname[ (membername [,membername |...) ].. 





J 





INSERT csectname[,csectname, ... | 


















-ddname(membername[,membername, .. )) 
LIBRARY (externalreference[, externalreference, .. -|) , yen 
| *(externalreference[ ,externalreference, .. ae 
NAME membername| (R) | 











( common area aaa) \ common area name l 
ORDER } f(P) ||, APY beets 
csectname ) \ csectname J 
OVERLAY symbol [ (REGION) ] 
common area name l j moe area name 
PAGE |. 1] Sats 
csectname f \ csectname 


csectname-| aaa 


















REPLACE 





entry name 





Linkage Editor Record Formats 

The following record formats are used with the linkage editor: 
F -- The records are fixed length. 
FB The records are fixed length, and blocked. 


The records are fixed length, blocked, and contain machine 
code control characters, 


The records are fixed length, blocked, and written in standard 


blocks, 


The records are fixed length and contain machine code control 
characters. 


The records are fixed length and written in standard blocks. 
The records are undefined length. 


The records are undefined length and contain ASCII control 
characters, 
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Linkage Editor Capacities 


Virtual storage allocated (in bytes) aa 


558 


























Maximum number of entries in composite external symbol 
dictionary (CESD) 


Maximum number of intermediate text records 









Maximum number of relocation dictionary (RLD) records 


Maximum number of segments per program 





Maximum blocking factor for input object modules (number of 
80-column card images per physical record) 


Maximum blocking factor for SYSPRINT output (number of 121- 
character logical records per physical record) 


On IBM 2314, 2319 

Storage Facility 30722 
On IBM 2305-2 Fixed Head 2 
Storage Facility 3072 


On iBM 3330 Disk Storage 
Facility 















Output text 
record length 
(in bytes) 








From 74K to 9999K for value] of the SIZE option, the blocking factor for input 
object modules and SYSPRINT output is 40. 


2The maximum output text record length is achieved when valueg of the SIZE 
parameter is at least twice the record length size. For example, on a 3330, 
12288 byte records are written when valued is at least 24576. 


Loader JCL Statements 










//name JOB parameters = (optional) 

//nome EXEC PGM=LOADER , PARM= (parameters) 

J/SYSLIN DD parameters 

//SYSLIB DD parameters (optional) 

J/SYSLOUT DD parameters (optional) 

//SYSTERM DD parameters (optional) 

// (optional DD statements and data required for loaded program) 














Input Deck for the Loader -- Basic Format 


Loader EXEC Statement 





The three loader names are: 
1. LOADER 


2. HEWLDRGO 
3, IEWLDRGO 
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Loader Execute Statement 


. The loader produces a map of the loaded program that lists external names 
and their absolute storage addresses on the SYSLOUT data set. (If the 
SYSLOUT DD statement is not used in the input deck, this option is ig- 
nored.) 


NOMAP.. A map is not produced. 


RES. An automatic search of the link pack area queue is to be made. This 
search is always made after processing the primary input (SYSLIN), and 
before searching the SYSLIB data set. When this option is specified, the 
CALL option is automatically set. 


NORES. No automatic search of the link pack area queue is to be made. 


CALL. An automatic search of the SYSLIB data set is to be made. (If the 
SYSLIB DD statement is not included in the input deck, this option is 
ignored .) 


NOCALL An automatic search of the SYSLIB data set will not be made. When 
or NCAL. this option is specified, the NORES option is automatically set. 


LET. The loader will try to execute the object program even though a severity 
2 error condition is found. (A severity 2 error condition is one that 
could make execution of the loaded program impossible .) 


NOLET. The loader will not try to execute the loaded program if a severity 2 
error condition is found. 


SIZE=size. Specifies the size, in-bytes, of dynamic main storage that can be 
used by the loader. 


EP =name. Specifies the external name to be assigned as the entry point of the 
loaded program. This parameter must be specified if the entry point 
of the loaded program is in an input module. For FORTRAN, 
ALGOL, and PL/I, these entry points must be MAIN, IHIFSAIN, 
and IHENTRY, respectively. 


PRINT. Informational and diagnostic messages are produced on the SYSLOUT 
data set. 


NOPRINT.. Informational and diagnostic messages are not produced on the 
SYSLOUT data set. SYSLOUT is not opened. 
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Loader Execute Statement (con't) DD Statements 

















TERM 
Numbered diagnostic messages are to be sent to the SYSTEM data set. The 
SYSTEM data set can be used to replace or supplement the SYSLOUT data set 
at any time. (If the SYSTEM DD statement is not included in the input deck, 

this option is ignored.) 






NOTERM 
Numbered diagnostic messages are not to be sent to the SYSTEM data set. 





Unless otherwise specified with the LOADER macro instruction during system 
generation, the default options are: NOMAP, RES, CALL, NOLET, SIZE=100K, 
and PRINT. The default options NAME=**GO and NOTERM cannot be changed 


during system generation. 





DD STATEMENTS 


The following considerations apply to the DCB parameter of SYSLIN, SYSLIB, 
ahd SYSLOUT. 


For better performance, BLKSIZE and BUFNO can be specified. 
If BUFNO is omitted, BUFNO =2 is assumed. 


Any value given to BUFNO is assumed for NCP (number of channel 
programs) . 


If RECFM =U is specified, BUFNO =2 is assumed, and BLKSIZE and 
LRECL are ignored. 


RECFM =V is not accepted. 

RECFM =FDSA is always assumed for SYSLOUT. 

If RECFM is omitted, RECFM=F is assumed for SYSLIN and SYSLIB. 
If BLKSIZE is omitted, the value given to LRECL is assumed. 
LRECL=121 is assumed for SYSLOUT. 


If OPTCD =C is used to specify chained scheduling, an additional 2K 
(2048 bytes) of main storage is needed in the user's region if the necessary 
data management routines are not resident. 


The SYSTERM data set will always consist of unblocked 81- character 
records with BUFNO =2 and RECFM=FSA. Because these values are 
fixed, the DCB parameter need not be used. 


In addition to the DD statements used by the loader, any DD statement and 
data required by the loaded program must be included in the input deck. 
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f— 


Loader Macro 







Name 


[symbol ] 








Operand 


een 
en; 


{ an 
XCTL 










EP=loadername 
PARAM=(optionlist [ ,ddname list] ) 
VL=1 


EP=loadername 



















Macro Instruction Basic Format 


Loader Macro Parameters 


EP 


specifies the symbolic name of the loader, The entry point at which execu- 
tion is to begin is determined by the control program from the library direc= 
tory entry. 


PARAM 


specifies, as a sublist, address parameters to be passed to the loader. The 
first Fullword in the address parameter list contains the address of the option 
list for the loader and/or loaded program. The second fullword contains the 
address of the ddname list. If standard ddnames are to be used, this list may 
be omitted. 


option list 


specifies the address of a variable length list containing the loader and 
loaded program options. This address must be written even though no list is 
provided, 


The option list must begin on a halfword boundary, The two high-order 
bytes contain a count of the number of bytes in the remainder of the list. 
If no options are specified, the count must be zero. 


The option list is free form, with the loader and loaded program options 
separated by a slash (/ ), and with each option separated by a comma. No 
blanks or zeros should appear in the list. 


ddname list 


VL 


specifies the address of a variable length list containing alternative ddnames 
for the data sets used during loader processing. If the standard ddnames are 
used, this operand may be omitted. 


The format of the ddname list is identical to the format of the ddname list 
for invoking the linkage editor; the 8-byte entries in the list are as follows: 


Entry Alternate Name For: 

SYSLIN 

not applicable 

not applicable 
SYSLIB 

not applicable 
SYSLOUT 

not applicable 
SYSTERM 


specifies that the sign bit is to be set to 1 in the last fullword of the address 
parameter list. 
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Loader Return Codes 






Loaded 
Loader | Program 
Return | Return | Return 

Code Code 















Conclusion or Meaning 


Program loaded successfully, and execution of the 
loaded program was successful, 






The loader found a condition that may cause an 
error during execution, but no error occurred during 
execution of the loaded program. 









Program loaded successfully, and an error occurred 
during execution of the loaded program. 












The loader found a condition that may cause an 
error during execution, and an error did occur during 
execution of the loaded program. 










Program loaded successfully, and an error occurred 
during execution of the loaded program 























The loader found a condition that may cause an 
error during execution, and an error did occur during 
execution of the loaded program. 







The loader found a condition that could make exe- 
cution impossible. The loaded program was not 


8 (LET) 
ial executed, 


Program loaded successfully, and an error occurred 

12 during execution of the loaded program. 
12 error during execution, and an error did occur 
8(LET) during execution of the loaded program. 


12 The loader could not load the program successfully, 
execution impossible, 
Program loaded successfully, and the loaded pro- 
gram found a terminating error. 
| 4 | 6 | The loader found a condition that may cause an 
error during execution, and a terminating error was 
8(LET) | 46.) found during execution of the loaded program. 
The loader could not load program, execution 
impossible, 
lError diagnostics (SYSLOUT and/or SYSTERM data set) for the loader will show 
’ the severity of errors found by the loader. 













The loader found a condition that may cause an 
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Loader Virtual Storage Requirements 


Consideration 


Approximate 
Main Storage 
Requirements 

(in bytes) 


Comments 





idee Control 


Code Processing 
Daia Management 


Object Module Buffers 
and DECBs 


400 





13250 
6K 


BSAM 





BUFNO(BLKSIZE+24) 


Concatenation of 
different BLKSIZE and 
BUFNO must be 
considered. (Minimum 
BUFNO=2) 








Load Module Buffer and 
DECBs, 


SYSTERM DCB 
Buffers, and DECBs 


Ns 


304 


312 


a ee 





SYSLOUT Buffers 
and DECBs 











Size of program being 
loaded 


Each external relocation 
dictionary entry 


BUFNO (BLKSIZE + 24) 


Program Size 





Each external symbol 


Largest ESD number 


Fixed Loader Table Size 


System 
Requirements 


20 





Allocated if TERM 
option is specified 


Buffer size rounded up 
to integral number of 
double words. 
(Minimum BUFNO=2) 





Program size is 
restricted only by 
available virtual storage 








An 
n is the largest ESD 
number in any input 
module 





Allocated in increments 
of 32 entries 








1260 


1600 
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Subtract 88 if NOPRINT 


_is specified 
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Macros 7-2 
Macro Instruction Format 7-5 
2715 User-Table Macro Instructions 7-9 
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TCAM 
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Operator Commands 7-19 
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», Source Publications 





Detailed information about BTAM and TCAM is contained in these 
publications: 


e OS/VS BTAM, GC27-6980 
e OS/VS TCAM Programmer’s Guide, GC30-2034 
e OS/VS2 TSO Guide, GC28-0644 
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BTAM Macros 


[symbol]} AS pean , ASGROUP=symbo |] 
[, DEGROUP=(symbol, absexp)] 


: 
[, DIGIT=(absexp 1, absexp2, absexp3)] 


[symbol ]} ASLIST 
[, ENTRY={5, | IL, MSG="'text'] 


su 
[symbol]}| CHGNTRY listaddr, listype, listposition, 
numchars, action 
[symbol] yore} ({dcb},...) yet ] 
CLOSE MF=(E, listname) 
_§16 NO 
[symbol] | CONFIGUR [cone={35 }] [. PC= {re | 


[symbol]]| CTRGROUP | ctrno, 


[sro], 
[symbol]} CTRLIST 
[,MSG='text'] 


[cttest], 

ID=absexp 

[, SROENAB={ NO} ] 
cor AMGT | ACSMETH=BTAM 




















2715 ONLY 








ID=absexp, 
HIGHCTR=absexp, 


RO | [ rigk \] 


[, LOG] 

[, ASLOG] ) 

[, EXTRALRM] 

[, NEXTAS=absexp] 


2715 ONLY 


2715 ONLY 











device-code, NORM=absexp 
|, LENGTH=(absexp 1, absexp2)] 









2715 ONLY 










2715 ONLY 
YES 


NULL 
,;CTINIT=) ——— 
| : NCT 


UNASP 


DEVCOD={ B 
Cc 


M 
CTRADR=$ IMP 
EXP 
CTRRD= aROUer 
CTTES T= 



















2715 ONLY 


i 2715 ONLY 
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BTAM Macros (con’t) 


[symbo|] | DEULIST [DI GIT=(absexp 1, absexp2)] 
|, LENGTH=absexp 1] 2715 ONLY 
[, MSG='text'] 
symbol | DFTRMLST list type, 
device-dependent 
operands 


[symbol] | IODEVICE UNIT=type, 
ADDRESS=address, 
ADAPTER=type, 
TCU=teleprocu 
[,FEATURE=(feature], feature2,...)]| 
[, SETADDR=typel 
[“OBRCNT=nt 


symbol | LERB nlines[, { ([transmet] 
[,datack],[, intreq] 
[,nontto])}...] 
& [symbol] LERPRT debaddr [rin] [, cid] 
[ Cc ee | 
,CLEAR=NO 


[symbol]| LOPEN decbaddr 


[symbo!]} ONLIST DECB=decb address, 
X=type of test, 
Y=no. of transmissions, 
DCB=dcb address, 
AREA=rft message area 
[, TEXT=user text area, 
LENGTH=user text length] 
[, ENTRY=list address] 
[,RLN=line number] 


[symbol]} OPEN See CLOSE 


[symbol] ee \ decbaddr, optype, dcbaddr, 
WRITE 

{ [inoutarea] \ 
(Linarea], [outarea]) , 

{ [inoutlength] \ 
(Linlength], loutlength]) , 

/MF=L 
[entry], [rln] [Me | 


[symbol ]] RELBUF debaddr, bufferaddr 
[symbol]] REQBUF debaddr, returnreg, [count] 


[symbol] RESETPL decbaddr[{, POLLING ] 
ANSRING 
TGROUP | [TCn=(symboln [,E] ) | 2715 ONLY 
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BTAM Macros (con’t) 


7 TPEDIT MINLN=n1, REPLACE={3, 1%; by 
; IN KK 
symbol | TRLIST 
[ TEXT= | , TRID=obsexp2 


_fEDITDY, SV. 
[,eit={ EDD recem={¥ \) 
[ ,ERROPT={ IGNORE i [,VERCH K={hOCHe \ 
name 
[symbol]] TRNSLATE [dcbaddr], tablename, area, length 
symbol! jeter Fx=code,... 


VOKCHK 
TRSLRCT3 














— 


[ purrer-{*O by 






ROUTE= 


([ero'}] L061 [{ asses] ) 


2715 ONLY 










World Trade 
Telegraph 
Terminal 
World Trade 
Telegraph 
Terminal 







symbol eels. Xyy=Fx,... 
TRSLSCT3 











IBM 50 
MAGNETIC 
DATA IN- 
SCRIBER 
ONLY 





Isymbo|]| TWAIT (returnreg), 
ECBLIST=ech list addr 






[symbo{]} WAIT [count] 
ECB=ecb address 
ECBLIST=ecb list addr 


[symbo!]} WRITE See READ 
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BTAM Macro Instruction Format 


Macro _ Dec | Register | RX- 

cet fo Be aSe 

Ca 

CHGNTRY =a oe HERE 
an ee a a ee ae ee a ee 
[listposition | | [x | | | | |x} | | | | 
|numchors [| Tx | cE TE hE xt oT 
Fcc ae FR a FA (a 

CLOSE oe 


ewe 
pmacrr= | | tt 4 = 
a oa 

peuri= TT ———— |— 






















[Ta a G B ee6  OS 
reurces | | | | [1k] || 

oo oo 
[ee ee ee 
a a a 
Ca a =e 


ee ae ete 
Fes Ot G(s Be 


DFTRMLST Cee eee Sees 
ei a eee 

(aaa fo 
2 SC FO a 

Fe A Sl (ee 
Proment | |» | | |} - ||. || _ 
fete ed deed el 
Fnumensent | |x| | | | 






7 PEEPS 
Shown 
CCCCCEreee ek Shown 
a ee ea = a ee 
| {x| | jai 
| | x | 
ae ae 






entrylength 
userlength 


idcount 


authsequence (or ce ca 
controlvelve | [x {| ot | | tT | ft | 
paueeriat EY ee 


*See macro description for allowable values. 
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BTAM Macro Instruction Format (con’t) 


Mocis | Register | | Register | py Hex 
Instruction —— = al ee “— ws = ee Char _ 


LERB 















pete 
peer et 
mf fk taf fst 
ae a eS Fi Fl ee ee a 


[a Cl 

OPEN [adecboadr |x | | x | | | | | | | | | 

ONLIST paces ff fa fet ef Pt 
Feed ea nel EF i a FES a ae Fe 






























ee eae 
Finouteres | | i 








*See mucro description for allowable values. 
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BTAM Macro Instruction Format (con't) 


Macro fe eee | _Register__| px - Hex 
Instruction Operand ae type a a = = — 


READ decbaddr 
0 ao 


(standard 
form) epiype 

debaddr Pc ea 

fe el eC Oa 

inarea op 
ce ee de 
eee ee 
fintenoth = | | [x | | | | [x] | | [| 
Ca 
eee eee re ee ee 
Se nes 
RELBUF | debader || S| x [x] |x| | | | | [| 
buffered | | te EL 
REQBUF | dcbadd fee tet | 
Cs a a 




































































ANSRING 





TRANSLATE | dcbaddr 


tablename 
















TRSLRCTW i=, 
Sa Fe 
vesiserw [x= | | | oT dT | TT | | | | 


msisere: [oe | | 
twat [Rewrneg | | [x | | | tT ft | fT ty | 

























Fame ad as al 6 i i 
wait feount | | fe | [efx] [xf | | TI 
aa Das es ee 
AS FR Le 
wate [aecboae [x | | [| [| [| | | ft ft 7 
Mey” [epee TT TT TdT | Th TP 
facboda TE a ne a Da fa 
finovtoree [| oT OT TT ie TT 
a ae le — 
fourree PE Ee 
jinoutlenoth | | | | | | | [xt | ft 7 
a ae ae a RE a ae a De 
ES a a ae (ese a 9 Ea ee ee 
fey TE Ee 
eas Sr i Oe a a 
se ea Ma en 





*See macro description for allowable values. 
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BTAM Macro Instruction Format (con't) 


Macro RX- Dec | Hex 
Instruction Operand a (2-12) a we ie 3 = aa aa or 


WRITE decbaddr 


eee 
‘deboar | | pera a 
See 





















WRITE 
(Standard 
form) 








*See macro description for allowable values. 
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2715 isd Table Macro Instructions 


= = 
Instruction we a Diet is ts = = | _ a = 


mea oe ae eae 


DEGROUP= 
tgroupname 
deunumber 


ice Pe ae Ee 
Pere ne fl Ee 
ee oe a eee 





































EXTALRM 





NEXTAS= 





rome 
LENGTH= 
| data length 
gdlight2 
DIGIT= 


entrypos 
compvalue 
gdlight3 











CONFIGUR 











CTRGROUP 


























emo [eo | | t 
peuuist [tenctH= | |x| | | | | | | | | | 


eee. | 1] TTT | dst | tt 
compvalue 
eee 
|STEND | rooperandcs | | | | | | | | | | 


TGROUP TCn= 
nce 
As 
7 Shown 


*See macro description for allowable values. 
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2715 User Table Macro Instructions (con't) 


Macro | Register | RX- Abs Dec | Hex 
Instruction Operand Dig eae al A a Pied Char a a 


























*See macro description for allowable values. 
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Line and Station Configuration Supported by BTAM 


Start-Stop Communications 


1. Nonswitched lines (point-to-point or multipoint), using programmed polling: 


IBM 1030 Data Collection System 

IBM 1050 Data Communications System 

IBM 1060 Data Communications System 

IBM 2260 Display Station -- 

IBM 2848 Display Control 
(Remote -- 2701 only) 

IBM 2265 Display Station -- IBM 2845 
Display Control (Remote -- 2701 only) 

IBM 2740 Communications Terminal (Model 1): 
Basic: with checking!; with Station Control‘; 
with Checking and Station Control2; or with 
Checking and IBM 2760 Optical Image Unit 
features (point-to-point only, if 2740 is 
equipped with 2760 Optical Image Unit) 
(Model 2): Basic or with Checking! 

IBM 2741 Communications Terminal 

Western Union Plan 115A Outstations 

AT&T 83B3 Selective Calling Stations 





Switched lines: 


IBM 1050 Data Communications System 

IBM 2740 Communications Terminal 
(Model 1): Dial; Dial, with Checking; 
Dial, with Transmit Control; Dial, with 
Checking and Transmit Control, or Dial, 
with Checking and IBM 2760 Optical 
Image Unit features 

IBM 2741 Communications Terminal 

WU Model 33/35 Teletypewriter 
Exchange Terminal (TWX) 


Nonswitched multipoint lines using the Auto Poll facility (IBM 2702 or 2703 
only): 


IBM 1030 Data Collection System 

IBM 1050 Data Communications System 

IBM 1060 Data Communications System 

IBM 2740 (Model 1): with Station Control 
or with Station Control2 and Checking 
features 





Used as a regular terminal or as an operator's console, when the operating system 
includes the Multiple Console Support. 





2Station Control feature cannot be used if the 2740 is also used as a console under 
§ = Multiple Console Support. 
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Line and Station Configuration Supported by BTAM (con’t) 


Binary Synchronous Communications 


We 


3 





Nonswitched point-to-point and switched point-to-point lines: 


IBM System/360° 


IBM System/360 Model 20 

IBM System/3 

IBM 1130 Computing System 

IBM 1800 Data Acquisition and Control System 

IBM 2715 Transmission Control Unit (Model 1 
attaches directly to multiplexer channel of 
central computer; Model 2 communicates 
with cenivaliconcole via IBM 2701 or 2703) 

IBM 2770 Data Communications System 

IBM 2780 Data Transmission Terminal 

Nonswitched multipoint lines: 

IBM System/360 Model 20 

IBM System/3 

IBM 1130 Computing System 


IBM 1800 Data Acquisition and Control 
System 


IBM 2715 Transmission Control Unit (Model 1 
attaches directly to multiplexer channel of 
central computer; Model 2 communicates 
with central computer via IBM 2701 or 2703) 


IBM 2770 Data Communications System 
IBM 2780 Data Transmission Terminal 


IBM 2972 (Models 8 and 11) General Banking 
Terminal System 


The remote System/360 may be a Model 25, 30, 40, 50, 65, 67 
(operating in 65 mode), 75, 85, or 91. 
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TCAM Macros 


[ symbol] CANCELMG [ mask ] poONeGrs ferey [: LEVEL= jure 1 
OR MSG 


[symbol] CHECK decbname 
[ symbol CHECKPT (no operands) 
[symbol] CKREQ (no operands) 


[symbol] CLOSE (dcbname,,... ne tr yi 


(E, listname) 


[ symbol] CLOSE (dcbname,,...) 
(MCP) 


[symbol] CODE tablename 
} NONE | 


(register) 
[ symbol] COUNTER opfield 
[ symbol ] CUTOFF integer 


[symbol] DATETIME pate ot] pee {Nov 
YES YES 


{ symbol] ERRORMSG [ mask] PEONNESTE ONY 
OR 
, DEST= (destination name 
opfield 
ORIGIN 
DESTIN 
, DATA= {message \ 
VAclicne 
[ ,EXIT=name of routine] 


| symbol] FORWARD DEST=( destname 

opfield 
(number) 
PUT 
x* 

[, EOA=characters ] 

[, EXIT =name} 

[, THRESH=nn ] 


[symbol ] dcbname | , areaname] 


[ symbol] [ mask] [ , RELEASE] [, INTVL=integer] 


Deans ec CN ice ] 
or JIL MSG 


ACT 


[ symbol] grpname ,rln (areaname 
{act -senesie 


[symbol } ICOPY grpname, rin, areaname 
[symbol ] INBLOCK [PATH= ( opfield, switch)]} 
[symbol ] INBUF [PATH= (opfield, switch) ] 
[symbol ] INEND (no operands) 


[symbol ] INHDR [PATH= (opfield, switch)] 
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TCAM Macros (con’t) 








[ symbol ] INITIATE conchars[, BLANK= (char 
YES 
[ symbol ] INMSG [ PATH= (opfield, switch) ] 
[ symbol ] INTRO keyword operands 
.».,PEATURE=(..., (CONC ) 
CONCO 
NOCONC . 
alae Hae 
0 
»7ENVIRON= (TSO 
MIXED 
TCAM 
FEATURES NODIAL|.{ No2741} { NOTMEE\) 
DIAL 2741 TIMER 
F ear Hea 
70 
aes integer 
of 
»MSUNITS= et 
o 
symbol INVLIST ORDER= (entry,...) [,EOT=hexchars] [,CPUID=addr ] 
[symbol ] LOCK EXTEND }[,conchars [, BLANK=( YES 
MESSAGE NO al 
char 
[ symbol ] LOCOPT alla lk 
(15) 
[ symbol ] LOG kali \ 
typename 
typename LOGTYPE dcbname, BUFSIZE=size, QUEUES=form 
[symbol ] MCOUNT DCB=/name 
(r) \ 
[ symbol ] MCPCLOSE QUIC reer Ae 
FLUSH 
[ symbol ] MRELEASE statname [ , PASSWRD=chars | 
[ symbol ] MSGEDIT ((group1), (group2 ),...), BLANK=(NO 
{ere 
ves 
[ symbol ] MSGFORM [BLOCK=integer] [, SUBBLCK=integer | 
[, COUNT=integer | t ee ee | 
N 
[,ENDCHAR=subblock delimiter] 
[ symbol ] MSGGEN [mask ] ee \ 
fieldname 
PSONR EST ANP 
OR 
peers oe 
Not | 
[ symbol ] MSG LIMIT 


{ integer 
sandr 
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TCAM Macros (con‘t) 


[ symbol ] MSGTYPE a —_ YES \ 
NO 


char 


.E, listname 
le, listname)) 


\ ? 


[ symbol] aa a: 1 


[ symbol ] (dcbname, [( OUTPOST) LIBRE) Peat) 
| }INOUT 
INPUT § 


[ MF=L 
MF=(E, vitnameyt | 
opfidname} OPTION typelength 


[ symbol ] ORIGIN [ vee 
X'FF! 


Cae 


[ symbol ] OUTBUF [ PATH=(opfield, switch) | 
[symbol | OUTEND (no operands) 

{ symbol ] OUTHDR | PATH=(opfield, switch) ] 
[ symbol ] OUTMSG [ PATH=(opfield, switch) ] 


NO 


char 


[ symbol | PATH switch ,opfield | conchars en {No tH] 


pcbname MH=mhname, BUFSIZE=integer 


[’ pes teas | pce | sae | 
2 2 


L, RESERVE=(integer] ,integer2) | 
[symbol ] POINT dcbname, address 


NO 
char 


{symbol ] PRIORITY a | conchars eto 1) 
[ symbol ] PUT dcbname [ , areaname] 
[symbol ] QCcOPY termname, areaname 


[ symbol] QSTART (no operands) 


[symbol ] READ decbname, SF, dcbname, areaname, 


eae 
= hes. listname) ] 


[ symbol ] READY [GMMSG=routine ] [ ,RSMSG=routine | 


[ symbol ] REDIRECT [ mask ] premeatare ] 
OR 


,DEST=(destname 
jeetel M 
ORIGIN 


INTVL=integer 
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TCAM Macros (con’t) 


[symbol } SCREEN fw yer ane {no | in 





WLA NO 
WDC char! 


[symbol ] SEQUENCE (no operands) 


[symbol ] SETEOF conchars [, BLANK=( YES 
char 


[symbol ] SETEOM ENDCHAR= eek i 


opfield 


| 
[: machi Sa \ ,opfield2 | 
| 


opfield| 


ies Os | | aaa sk ai 
NO NO 


cat ike tric ) 


[prone tORVARD Hf diag trina | 
FORWARD KEEP § 
E RESULT= {3 register *] 


mhname STARTMH as Ween bee 
OUTIL (CONT Grdiewnaon 


,CONV= (YES 
{epriels siren} 
NO | 


[: LOGICAL= alan ) \] 
(opfield1, switch ,opfield2) 


[: pa ae Se NON it ed | 


[symbol ] TCHNG termname,areaname [, PASSWRD=chars | 


[symbol] SETSCAN 


[symbol ] TCOPY statname ,areaname 


[symbol ] TERMINAL ene 

L 

, QUEUES=form pera hes jee aesiee! 
NONE) 


i DCB=dcbname, RLN=integer, TERM=type 


[ ,LEVEL=(integer,...)] [,CLOCK=time] 
[, CINTVL=integer ] [, BUFSIZE=integer]} 
[ ,ALTDEST=entry ] [, BFDELAY=integer | 
[ ,NTBLKSZ=(blocksize, subblocksize) | 
[ , TBLKSZ=integer ] [, OPDATA=(data,...)] 
[ ,RETRY=integer ] f sige | f Ney 
NO NO 
ne Not | [ee ee 
NO OAT 


[ 
: mabe eG ae NGT 


,DVCID=( (CONC [, integer } ) 
“| shor 
NONE 


| 


QCNTRL=( (MSG msgcount x 
[ Gta 


bytecount 
[,L] [,STATUS] char} )| 
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TCAM Macros (con’t) 


Operation 


Operands 





TERMINAL 


(continued) 


[symbol ] 


[symbol ] TERRSET 
[ symbol ] TLIST 


[symbol ] TPDATE 


TPEDIT 


TPROCESS 


procname 


[ symbol ] TTABLE 


[symbol ] UNLOCK 


[symbol ] 


{ ,CTBMAX=integer | 

{ , SCRSIZE=(n,m) ] 

aes ae ies eae | 
NOBREAKJ LNOATTN 


(no operands) 


pet DY, LIST=(entry,entry,...) 
CJ 


os (eh k Se nos | 


[: DTSAREA= eae i sae foe 


MINLN=n, sal er ali 
EDITD Nv 
ames ote 
NOCHK 


ERROPT gua 


IGNORE 


laid 7 BUFFER= es 
X'19! NO 


PCB=pcbname [, QUEUES=form ] [ , ALTDEST=entry ] 


[’ piace ie f ue Nea 


k as ea [, RECDEL=delimiter] 
NO 


[| , LEVEL=(integer,...)|[, OOPDATA=(data,...)] 


LAST=name [, MAXLEN=integer ] 


conchars [, BLANK=( YES 
ee 
char ! 


decbname, aa aa length \ 
sr 
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TCAM Macros (con't) - 


[symbol] CTBFORM [ opfield] Kees eee Carats { NO tI 
YES YES 





[symbol] INTRO » ee, FEATURE=(..., ( CONC )) 
CONCO 
NOCONC . 
[symbol] MRELEASE statname | , PASSWRD=chars |} 


[ symbol ] ORIGIN Ge { ID \] 
NAME 





[ symbol] QACTION TYPE= { At ,EXIT=name 
x 


chars 


symbol TERMINAL | ia (CONC [ ee) 
NONE 





oe ALL 


(MSG [, { msgcount )( 
['{ Hy 


] 


| bytecount 
[ ,L][, STATUS] [, char ] | [ ,CTBMAX=integer | 


mes name of ori 
opfield 
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TCAM Operator Commands 


control chars {DISPLAY} 
{D} 


Control Chars 



































TP, LIST,{ grpname, rin} 
{ address} 


TP, OPTION, statname, opfidname 


TP, PRITERM 





TP, QUEUE, statname 


TP,ACT, {grpname,rin} 
{ address } 

TP, ADDR, statname 

TP, INACT, {grpname, rin } 
{address } 

TP, INTER 

TP, LINE, {grpname, rin} 
{address} 

TP, SECTERM 





TP, TERN, statname 











control chars HALT} TP, {QUICK} 
{Z} {FLUSH} 
control chars {HOLD} TP=statname 
{H} 
control chars { MODIFY } id, AUTOPOLL= {grpname, rin}, OFF 
{F} (address } 
id, AUTOPOLL= {grpname,rin}, ON 
{ address } 
id, INTERVAL=POLL, statname, data 
id, INTERVAL=SYSTEM 
id, INTERVAL=SYSTEM, data 
id, INTENSE=LINE,{grpname,rin}, 
{ address} 
{MODIFY} sense, count 
{F} 
id, INTENSE=TERN, statname, sense, count 
id, OPERATOR={statname } 
{SYSCON} 
id, OPT=statname, opfldname , data 
id, TRACE={grpname, rin}, OFF 
{address } 
id, TRACE=(grpname rin}, ON 
{address} 





Section 7; BTAM/TCAM/TSO_ 7-19 





TCAM Operator Commands (con’t) 


control chars {RELEASE} 
{A} 


control chars {VARY} 
{V} 





TP=statname 





statname, ONTP,B 


statname, ONTP,E 


statname, OFFTP,B 


statname, OFFTP,E 


{(grpname, rin)}, OFFTP,{C} 
{grpname, } {i} 
{address} 


{(grpname ,rln)}, ONTP 
{grpname, } 


{address} 
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Device Configurations Supported by TCAM 


IBM 1030 Data Collection System 
IBM 1050 Data Communication System 
IBM 1060 Data Communication System 
os IBM 2740 Communication Terminal 
wy {BM 2740 Model 2 Communication Terminal 
IBM 2741 Communication Terminal 
1BM 2760 Optical Image Unit 
IBM 2260 Display Complex (Remote) 
| IBM 2265 Display Complex (Remote) 
AT&T 83B3 Selective Calling Stations 
WU Plan 115A Outstations 
TWX Models 33 and 35 
World Trade Telegraph Terminals 





IBM 2770 Data Communication System 
IBM 2780 Data Transmission Terminal 

IBM 1130 Computing System 

IBM 2790 Data Communication System 
IBM 3270 Information Display System 

IBM 3670 Brokerage Communication System 
IBM 3735 Programmable Buffered Terminal 
9701 IBM 3780 Data Communication Terminal 
BSC IBM System 3 

IBM System/360 Model 20 

IBM System/360 Models 25 and above 








IBM 1030 Data Collection System 

IBM 1050 Data Communication System 

2702 IBM 1060 Data Communication System 
IBM 2740 Communication Terminal 
IBM 2740 Model 2 Communication Terminal 

1 IBM 2741 Communication Terminal 
IBM 2760 Optical Image Unit 
AT&T 83B3 Selective Calling Stations 
WU Plan 115A Outstations 

2703 TWX Models 33 and 35 

World Trade Telegraph Terminals 


CPU 


IBM 1030 Data Collection System 

{BM 1050 Data Communication System 
IBM 1060 Data Communication System 
IBM 2740 Communication Terminal 

IBM 2740 Model 2 Communication Terminal 
IBM 2741 Communication Terminal 

IBM 2770 Data Communication System 
{BM 2780 Data Transmission Terminal 

[BM 1130 Computing System 

IBM 2790 Data Communication System 
7770 IBM 3270 Information Display System 

IBM 3670 Brokerage Communication System 
IBM 3735 Programmable Buffered Terminal 
iBM 3780 Data Communication Terminal 
IBM System 3 

q IBM System/360 Model 20 

IBM System/360 Models 25 and above 
AT&T 83B3 Selective Calling Stations 
WU Plan 115A Outstations 

TWX Models 33 and 35 

World Trade Telegraph Terminals 

IBM System/370 Models 135 and above 


2848 











IBM 2260 Display Complex (Local) 


Device Configurations Supported by TCAM 
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PLEASE COMMENT 


Use Reader’s Comment Form 
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Device Configurations Supported by TCAM (con't) 


Channel! Type TCU Line Type 
System 


IBM 2701 {BM 2702 | IBM 2703 
Data Adaptor | Transmission| Transmission | IBM 7770 
Multiplexer | Selector | Unit Control Control Mo 
% 
IBM 1050 Data Auto Poll 
Communication System ae : 


IBM 1060 Data Auto Poll] x | 
a 


x 
x 
x 
x 

Communication System 
x 
x 
x 
x 
x 













Station Type Notes 


















IBM 1030 Data Collection | Auto Poll 








The IBM Digital Time Out 
feature cannot be attached 
through an IBM 2701 TCU. 








x 


Zz 

| ° 

x |x| x | 3 
= 

> 

a 

a5 

o 

oa. 




















: aie 
a. 
@, 





ry 
1 
| 


weit | 


x 


x 


IBM 2260-2848 Display 
Complex (Remote) 

IBM 2260-2848 Display 
Complex (Local) 


IBM 2265-2845 Display 

Complex (Remote) 

IBM 2740 Model 1 Auto Poll 
Communication Terminal 


hee ——- 
I 
z | 
x 
x 
x 























Two Types: 
2740 with station contro! 
2740 with station control 
and record checking 


ww 
=, 
x a 
> 
rs 
a 


| 
Pod cde i. 


Four Types: 

2740 basic 

2740 with station control 
2740 with record checking 
2740 with station control 
and record checking 


x 
Four Types, all with dial: 
2740 
x 2740 with transmit control 
2740 with record checking 
2740 with transmit control 
and record checking 
— ath 
Pp [ef fe 
| Lee 


1BM 2741 Communication 
Terminal 












IBM 2740 Model 2 


Four Types: 
Communication Terminal 


2740 
2740 with record checking 

2740 with buffer receive 

2740 without buffer receive 
(requires lines slowdown feature) 











Four types: 
2740 

2740 with record checking 
2740 with buffer receive 
2740 without buffer receive 


= 


“ 
a 
. | | 


Device Configurations Supported by TCAM 
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Device Configurations Supported by TCAM (con’t) 











Channel Type 








Audio 
Response 
Unit 




















Station Type 





Multiplexor | Selector 


ee 


IBM 2701 
Data 
Adapter Unit | Control 

















IBM 2702 IBM 2703 
Transmission| Transmission 
Control 


IBM 7770 
Model 3 


























1BM 2760 Optical Image 
Unit 









IBM 2770 Data 


Line Type 

















x 






















Terminal 









IBM 2790 Data 
























Display System 











Attached to a 2740 Model | 
with record checking 


i 


BSC transmission using either 






































Buffered Terminal 






IBM 3780 Data 



































IBM System 3 


































































and above 















Calling Stations 
































Outstations 





































x 
x x 
Communication System ASCII or EBCDIC 
IBM 2780 Data Transmission x x BSC transmission using ASCII, 
EBCDIC, or 6 bitcode. 
x x 
Communication System 
IBM 3270 Information x 
IBM 3670 Brokerage x BSC transmission using 
Communication System EBCDIC 
IBM 3735 Programmable x x Either ASCII or EBCDIC 
x BSC transmission using ASCII 
Communication Terminal or EBCDIC 
{BM 1130 Computing System x x BSC transmission 
x x Code TERM=202A or TERM= 
202B on TERMINAL macro: 
inquiry/response not supported 
IBM System/360 Model 20 x x BSC transmission using either 
| ASCH or EBCDIC 
IBM System/360 Models 25 x x BSC transmission and point - to 
point lines only 
AT&T 8383 Selective x x x 
Western Union Plan 115A x x ie 
TWX Models 33 and 35 x x x Teletype terminal, dial service 
(8= level code) 
x x x 


World Trade Telegraph 
Terminals 


Audio Terminals 


x 
x 
oe 
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Control unit must incorporate 
a WTTA 















Device Configuration Supported by TCAM 






Example: IBM 2721 Portable 
‘Audio Terminal 




















TSO/TCAM 


TCAM Macros Modified for TSO 


MH =mhname, CPRI = (R LaTRANS \topie\ J 
fe list 
2 


[ symbol ] INTRO ENVIRON =( TSO fae ey 
\moxeo! 0 
TCAM 
,MSMIN { ed das { a 
50 70 
, MSUNITS “{ ee 
Q 
, FEATURE ae ‘| NO274] i 5) a 
DIAL 274] TIMER 


= 


[ symbol ] PATH switch, opfield 


symbol TERMINAL TERM =type, QUEUES = form [, SCRS!ZE =(n,m) | 
[ ,FEATURE gi eee aes. } [ TOSUPPR ])] 
NOBREAK | LNOATTN 


TCAM Macro Instructions not used in TSO MH 
CHECKPT DATETIME ERRORMSG FORWARD HOLD 
INITIATE LOCK MSGEDIT MSGFORM MSGLIMIT 
MSGTYPE ORIGIN PRIORITY REDIRECT SCREEN 
SEQUENCE SETEOF SETSCAN UNLOCK RETRY 


SETEOM 
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TSO/TCAM (con't) 


ee 
a 
i 
a 


STARTMH [ ,TSOMH = ner 
NO 


symbol TRANSLIST ee \ pee) 
, OPFLD =opfldname 


username 
[ symbol ] TSINPUT (no operands) 


pais) ce \ earpirn | ane dae 
TSO Operator Commands 


username username 
Se a 
cont chars ale aac (eee 
address 
Nee TP, QUEUE, statname 
cont chars ae yy susn} 
Vauaet 


eeey {ieee aidamiiien) 
{; jobname 
INTERVAL =SYSTEM 
cont chars aa \ (grpname,rin) ) ,OFFTP, {¢ \ 
V grpname | 
address 

























CHARS =(control chars, ...) 
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ww Format 8-2 


Section 8: OS/VS Utilities 


Guide to Utility Program Functions 8-3 
IBCDASDI 8-5 IEBTCRIN 8-21 
IBCDMPRS-_ 8-7 IEBUPDTE 8-26 
ICAPRTBL 8-8 IEHATLAS = 8-28 
* , IEBCOMPR’ 8-9 TIEHDASDR_ 8-29 
a) IEBCOPY 8-10 IEHINITT 8-32 
IEBDG 8-12 IEHIOSUP 8-33 
IEBEDIT 8-15 IEHLIST 8-34 
IEBGENER__ 8-16 IEHMOVE 8-35 
IEBISAM 8-18 IEHPROGM_—_ 8-38 
IEBPTPCH 8-19 IEHSTATR = 8-40 


wy Definition of Operands 8-42 


Source Publications 


Additional information about OS/VS Utilities is contained in 
IBM System OS/VS Utilities, GC35-0005. 





& 
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Utility Programs - listed by class 


Utility Programs - listed by class 


SYSTEM DATA SET | NDEPENDENT 
Utility Programs Utility Programs Utility Programs 






































JEHATLAS IEBCOMPR IBCDASDI 
IEHDASDR IEBCOPY IBCDMPRS 
IEHINITT IEBDG ICAPRTBL 
IEHIOSUP 1EBEDIT 
IEHLIST jEBGENER 
IEHMOVE IEBISAM 
IEHPROGM |EBPTPCH 
IFHSTATR IEBTCRIN 

IEBUPDTE 


The utilities section is arranged in alphabetical order for easy reference. 


The control statement for the utility programs have the following standard format: 


[Tabet operation | operand | 


The label symbolically identifies the control statement. When included, a label must 
begin in the first position of the statement and must be followed by one or more blanks. 
It can contain from one to eight alphameric characters, the first of which must be 
alphabetic. 


The operation identifies the type of control statement. It must be preceded and followed 
by one or more blanks. 


The operand is made up of one or more keyword parameters separated by commas. The 
operand field must be preceded and followed by one or more blanks. Commas, paren- 
theses, and blanks can be used only as delimiting characters, 


A definition of operands table is located at the back of this section. It should be used, 
when needed, as a recall mechanism; it is not intended for use as tutorial information, 
If you require additional information, refer to the source publication listed for this 
section, 
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Guide to Utility Program Functions 


Task 


Add 

Analyze tracks on direct access 
Assign alternate | to a direct access volume 
tracks 
a generotion-data-group index 


a generation 


a data set 

a generation data set 
Change data set organization 
ogical record length 


Catalog 





‘° 
Cl 
O 
4 


volume 









onvert to a partitioned data set 
sequential an indexed=sequential data set 
Copy a catalog 
a direct access volume 






a partitioned data set 





members 


selected members 





m 
=< 
< 
m 


Utility Program 


IEHPROGM 
IEHATLAS, JEHDASDR, 
IBCDASDI 

IEHATLAS, {EHDASDR, 
IBCDASDI 

IEHPROGM 


EHPROGM 
EHPROGM 
EBUPDTE 


volume serial number of direct access IEHDASDR 


a partitioned data set 
sequential data sets 
Compress in a partitioned data set 
place 
volumes 
Construct records from MTST and MTDI input 
Convert to a sequential data set created as a result lEBCOPY 
partitioned of an unload 
sequential data sets | IEBUPDTE, IEBGENER 


IEBUPDTE, IEBGENER 


5 


IEHMOVE 


IEBCOPY, IEHMOVE 


|ave - 2 of data sets IEHMOVE 
an -fid:.xed-sequential data set IEBISAM 
cataloged data sets 
dumped data from tape to direct access IEHDASDR, IBCDMPRS 
job steps BEL 


p R, IEBUPDTE, 
IEBDG 
1EBCOPY, IEHMOVE 

‘ NJ 


sequential data sets 
IEBUPDTE 
reat Va library of partitioned members | 1EBUPDTE 
Tamember EBD 
[a sequential oulput data set | 1eBDG___ 
Lon index structure | EHPROGM 
Edit and convert | a sequential data set IEBGENER, IEBUPDTE 
to partitioned 
Edit and copy a job stream 
a sequential data set = EBGEN 








operation 


Edit and list IFHSTATR 
Edit and print a sequential data set _ | 1EBPTPCH 
Edit and punch | a sequential data set IEBPTPCH 
a procedure into a procedure libra 


a partitioned data set member froma copy | IEBCOPY, IEHMOVE 





a partitioned data set 

a sequential data set 

test data 

on a direct access volume 


Generate 
Get alternate 
tracks 








IEBCOPY 


IEHATLAS 
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4 
wh 
O 


JIEHDASOR, IBCDMPRS, 


{ 


2 


IEBGENER 
1EBDG 
JEHDASDR, IBCDASDI, 
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Guide to Utility Program Functions (con’t) 


Include changes to members or seqr tial data sets IEBUPDTE 
Initialize a direct access volume __ IEHDASDR, iBCDASDI 


Insert records into a partitioned dato + IEBUPDTE 
Label magnetic tape volur _TEHINITT 
List a password entry 
































































IEHPROGM 
a volume table of contents IEHLIST 
contents of direct access volume on system IEHDASDR 
output device 

number of unused directory blocks and 
tracks 

partitioned directories 

the contents of the catalog (SYSCTLG 

data set) _ 
a previously unloaded partitioned data set 
an indexed-sequential data set 
an unloaded data set 

| UCS and FCB buffers of a 3211 
Merge partitioned data sets 

Modify a partitioned or sequential data set 



























IEBCOPY 















IEHLIST 
IEHLIST 
























lEBCOPY 
[EBISAM 
[EHMOVE 
IEHMOVE, IEBCOPY 
IEBUPDTE 










































































IEBUPDTE 


























































partitioned data sets 
selected records 





Move a catalog 
a volume of data sets 
Cataloged data sets 
ttitioned data sets 
in a partitioned data set JEBUPDTE 
add a password IEHPROGM 
Print a sequential data set JIEBGENER, IEBUPDTE, 
IEBPTPCH 
Punch a partitioned data set member IEBPTPCH 
a sequential data set | TEBPTPCH 


sequential data sets 

delete a password IEHPROGM 
IEBPTPCH 

selected records {EBPTPCH 


in a new member 
Password protect 
IEHPROGM 
IEBPTPCH 
Tape Cartridge Reader input IEBTCRIN 





























Reblock a paritioned data set IEBCOPY 

o sequential data set IEBGENER, IEBUPDTE 
Recover data from defective tracks on direct access | IEHATLAS 

volumes 
Release a connected volume IEHPROGM 















IEBCOPY, IEHPROGM 


a partitioned data set member 
a sequential or partitioned data set 
moved or copied members 
logical records IEBUPDTE 
a password IEHPROGM 
identically named members 
logical records 
records in a member IEBUPDTE 
selected members in a move or copy IEHMOVE 
operation 
IEHPROGM 
JEHPROGM 
|EHPROGM 
JEHMOVE, IEBCOPY 



























Replace 















Scratch 













IEHMOVE 


an indexed-sequential dota set IEBLSAM 
ats IEHIOSUR 
TTR Entries in the supervisor call librar IEHIOSUP 
Write IPL records and a program on a direct access | IEHDASDR 
volume 








8-4 OS/VS Programmer’s Reference Digest 


IBCDASDI 
IBCDASDI, an independent utility: 
e@ Analyzes tracks on direct access volumes. 
e Assigns alternate tracks to a direct access volume. 
e Gets alternate tracks on a direct access volume. 
e Initializes a direct access volume. 





Job Control Statements 


Because IBCDASDI is an independent utility, job control statements are 
not used, 


4 i: Control Statements 
indicates the beginning of an IBCDASDI job. 


defines an output device for operator messages. 
DADEF defines the volume to be initialized. 


VLD contains information for controlling the location of the 
volume table of contents. 


IPLTEXT separates utility control statements from any IPL program 
(optional) | text statements. 
indicates the end of an IBCDASDI job. 


LASTCARD | used to end a series of stacked IBCDASDI jobs. 
(optional) 


VTOC Entries per Track 















Device VTOC Entries per Track 


2314 25 
2319 25 
2305-1 18 
2305-2 34 
3330 39 
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IBCDASDI (con’t) 


Format 


joe co TODEV=xxxx 
TODADDR=cuu 
DADEF 
[BYPASS=YES] 
[MODEL=n] 
[label] |} VLD NEWVOLID=serial 
aaa 
1 
[OW NERID=xxxxxxxxxx ] 
[ADDLABEL=n] 


[label] “VTOcD STRTADR=nnnnn 
EXTENT=nnnn 
[BYPASS=Y ES] 


[label] | GETALT 
[MODEL=n] 


[aa eww 
a 


























TODEV=xxxx 

TOADDR=cuu 

[IPL=YES] 

case elt 
SCRATCH 

[FLAGTEST=NO] 

[PASSES=n] 























TODEV=xxxx 
TOADDR=cuu 
TRACK=ccechhhh 
VOLID=serial 
[FLAGTEST=NO] 
[PASSES=n] 
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IBCDMPRS 


IBCDMPRS, an independent utility: 


Copies a direct access volume. 

Copies dumped data from tape to a direct access volume. 
Copies to tape. 

Dumps a direct access volume. 

Restores a dumped direct access volume from tape. 





Job Control Statements 


Because IBCDMPRS isan independent utility, job control statements are not used. 





Control Statements 


RESTORE identifies the source volume whose data is to be restored and the 
receiving volume. 


indicates the end of an IBCDMPRS job. 


Format 


[308 | wewrniomaiod 


[label] | MSG TODEV=xxxx 
TOADDR=cuu 


[label] | DUMP FROMDEV=xxxx 
FROMADDR=cuu 
TODEV=xxxx 
TOADDR=cuu 
[VOLID=serial [, serial]] 
[MODE=mm] 
[MODEL=n] 


VDRL BEGINeEnnnnn 
[END=nnnnn] 


RESTORE FROMDEV=xxxx 
FROMADDR=cuu 
TODEV=xxxx 
TOADDR=cuu 
VOLID=serial 
[IMODE=mm] 
[MODEL=n] 


a 
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ICAPRTBL 


ICAPRTBL, an independent utility: 
@ Loads UCS and FCB buffers of a 3211. 





Job Control Statements 


Because ICAPRTBL is an independent utility, job control statements are not used. 


Control Statements 
JOB indicates the beginning of an ICAPRTBL job. 
contains an image of the characters to be loaded into the UCS buffer. 


defines the image to be loaded into the FCB. 
END indicates the end of an ICAPRTBL job. 























Format 


el 


N 


sit 
8 


LNCH=((I,¢)[,(I,¢)-+-]) 


FORMEN D=x 
ICAPRTBL Wait-State Codes 















Meaning Meaning 

Visually check the train image Reader not ready. 

printed on the 3211. Reader unit check (display low main 
Missing control card or control storage location 2 through 7 for sense 
card out of order. information). 

Incorrect JOB statement. Reader channel error. 

Incorrect DFN statement. No device end on reader. 

Incorrect UCS statement. Printer not online. 

Incorrect FCB statement. Printer not ready. 


Incorrect END statement. Printer unit check (display low main 
External interrupt. storage location 2 through 7 for sense 
Program check interrupt. information). 

Machine check interrupt. Printer channel error. 

Reader not online. No device end on printer. 
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IEBCOMPR 
1ESCOMPR, a data set utility: 


e@ Compares partitioned data sets. 
e@ Compares sequential data sets. 


Return Codes 


00 - successful completion. 

08 - unequal comparison - processing continues. 

12 = unrecoverable error - job step terminated. 

16 = a user routine passed a return code of 16 to IEBCOMPR - job 


" step is terminated, 


Job Control Statements 


//name JOB 
J, EXEC PGM=lIEBCOMPR 


//SYSPRINT DD data set definition (output messages) 
//SYSUT1 DD data set definition (input data set) 
w //SYSUT2 DD data set definition (input data set) 


//SYSIN DD } * 


DUMMY 


"IEBCOMPR control statements" 


Note - If the input is sequential and no user exits are provided, the DUMMY 
parameter for the SYSIN DD statement is used. In this case, no utility 
control statements are required. 





Control Statements 
COMPARE | indicates the organization of a data set. 
EXITS identifies the user exit routines to be used. 


LABELS indicates whether user labels are to be treated as data, 





Format 


[label] | COMPARE TYPORG= PS 
PO 


[label] | EXITS [INHDR=routinename] 
[INTLR=routinename] 
[ERROR=routinename] 
[PRECOMP=routinename] 





[label] | LABELS DATA= ( YES 
NO 
ALL 
ONLY 
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iIEBCOPY 
IEBCOPY, a data set utility: 


Compresses in place, a partitioned data set. 

Converts to partitioned, a sequential data set. 

Copies a partitioned data set. 

Copies selected members. 

Excludes a partitioned data set member from a copy operation. 
Expands a partitioned data set. 

Lists the number of unused directory blocks or tracks. 

Loads a previously unloaded partitioned data set. 

Merges partitioned data sets. 

Reblocks a partitioned data set. 

Replaces records or selected members in a partitioned data set. 
Unloads a partitioned data set. 








Return Codes 


00 - indicate. successful completion. 
04 - indicates a condition from which recovery may be possible. 
08 - indicates an unrecoverable error. The job step is terminated. 





Job Control Statements 


//name JOB 

//name EXEC PGM=IEBCOPY|, PARM='SIZE=nnnnnnnn[K ]'] 
//SYSPRINT DD data set definition (output message) 

//\NPUT DD data set definition (input data set) 
//OUTPUT OD data set definition (output data set) 
//SYSUT3 DD data set definition (spill data set - optional) 
//SYSUT4 DD data set definition (spill data set - optional) 
//SYSIN DD * 


"IEBCOPY control statements" 
Yh 
The optional PARM information in the EXEC statement is used to define the number 


of bytes used as a buffer. The nnnnnnnn can be replaced by one to eight digits. 
The K causes the nnnnnnnn to be multiplied by 1024, 





Control Statements 


COPY indicates the beginning of a copy operation. 
SELECT specifies which members in the input data set are to be copied. 


EXCLUDE | specifies members in the input data set to be excluded from the 
copy step. 
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IEBCOPY (con't) 


Format 


[label ] 








OUTDD=ddname 
,INDD= (ddnamel[,ddname2]... 
\échome! [,ddname2] [, (ddname2,R)]... 
((ddnamel,R)[,ddname2]...) 
[, LIS T=NO] 


*The INDD parameter may appear on a separate card; 
if this option is selected, the INDD parameter is not 
preceded by a comma (,). 








SELECT 


¢ ; | tlabet I EXCLUDE 

















[,name2 
MEMBER= [ [(]Jnamel [, (name2, ,R ]...[)] 
[, (name2, newname[,R]) | 
,newname|[, R]) 
(oamet [,name2]...) 


a) 


MEMBER=[(]membername1][,membername2]... [)] 
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1IEBDG 
IEBDG, a data set utility: 


e@ Converts to sequential, an indexed sequential data set. 
e@ Copies or creates members. 

e@ Creates a sequential output data set. 

e Generates test data, 





Return Codes 


00 - successful completion. 

04 - a user routine returned a code of 16 to the IEBDG program. The job 
step is terminated at the user's request. 

08 - an error occurred while processing a set of utility control statements. No data is 
generated following the error, Processing continues normally with the .ext set of 
utility control statements, if any. 

12 = indicates that an error occurred while processing an input or output data set. The 
job step is terminated. 

16 = an error occurred from which recovery is not possible. The job step is terminated. 


Job Control Statements 


//name parameters 

PGM=IEBDG[, PARM=LINECNT=nnnn] 
//SYSPRINT data set definition (output message) 
//SEQIN data set definition (sequential input - optional) 
//PARIN data set definition (partitioned input - optional) 
//SEQOUT data set definition (sequential output - optional) 
//PAROUT data set definition (partitioned output - optional) 
//SYSIN ‘. \ 

DATA 


"IEBDG control statements" 


The optional PARM information in the EXEC statement is used to specify the 
number of lines to be printed between headings in the message data set. The 
nnnn is a four-digit decimal number that specifies the number of lines (0000 to 
9999) to be printed per page of output listing. 


The DSNAME parameter for the PARIN and PAROUT DD statements can be 
coded as DS NAME=setname (membername). 





Control Statements 


| DSD | specifies the ddnames of input and output data sets. 


defines the contents and lengths of fields to be used in creating a 
output records. _ 
CREATE] defines the contents of output records. 


REPEAT | specifies the number of times a CREATE statement or group of 
CREATE statements are to be used in generating output records. 
marks the end of a set of IEBDG utility control statements. . 
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IEBDG (con’‘t) 


IBM Suppled Patterns 














Type Hexadecimal Printable Characters 



































Packed Decimal 0000... 001C 
(Positive pattern) 
Se 0000...001D 
wy (Negative pattern) Not applicable 
Binary Number 00...01 
(Positive pattern) 
FF...FF 
(Negative pattern) Not applicable 








Collating Sequence 40...F9 be. < (H&I$*);-/,%  >?:#@Is" > 
Ansel Oee9 
Randon Number Random hexadecimal Not applicable 
digits 


Note: A packed-decimal or binary number is right-aligned in the defined field. 





Format 


Pe 


[label] | DSD OUT PUT=(ddname) 
[label] 


[, INPUT=(ddname,...)] 
* specifies IBM Pe ee eer eee patterns - see table below. 
Pe ee eer eee how the contents of a defined field are to be altered - see table below. 


: 


*Use at least one of the optional parameters. 











NAME=name 
,LENGTH=length-in-bytes 
L, STARTLOC=starting-byte-location] 


‘character’ 
L rll) 


| 

err 

[, FORMAT=pattern* [, CHARACTER=character]] 
character-string ) 

[, PICTURE=length, | cctnl-romber ] 
B'decimal-number' 

[, SIGNEsign] 

[,ACTIONEaction]** 

[, INDEX=number[, CYCLE=number] [, RANGE=number]] 

[, INPUT=ddname] 

[, FROMLOC=number] 





[QUANTITY=number]} 


§ 'character’ 
{FILL= | 


{ X'2-hexadecimal-digits' 
ddname 







[INPUT= 
SYSIN[(cecc)] 
‘character-string' * 
[PICTURE-lenthstartoc, P'decimal=number' hi 
B'decimal-number' 


name 
[NAME= (namel ,name2...) ] 
(name, (COPY=namel ,name2...).+«) 





{EXIT=routinename] 
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IEBDG (con't) 


Format (cont'd) 


} abel | REPEAT QUANTITY=number[, CREATE=number] 


Format = Action = 






FORMAT=AN -- alphameric. ACTIONGSL -- shift left. 
FORMAT=ZD -- zoned decimal. ACTIONESR -- shift right. 
FORMAT=PD -- packed decimal. ACTIONE=TL -- truncate left. 
FORMAT=CO -- collating sequence. ACTIONE=TR == truncate right. 





FORMAT=BI -- binary. ACTIONERO -- roll. 

FORMAT=AL -- alphabetic. ACTION=WV -- wave. 

FORMAT=RA -- = random binary number. | ACTION=FX —- fixed. 
ACTIONERP -- ripple. 
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IEBEDIT 
IEBEDIT, a data set utility: 


e Copies job steps. 
e Creates an output job stream, 
@ Edits and copies a job stream. 





Return Codes 


00 - successful completion. 

04 = indicates that an error occurred. The output data set may not be usable 
as a job stream. Processing continues. 

08 - indicates that an unrecoverable error occurred while attempting to process 
the input, output, or control data set. The job step is terminated. 


Job Control Statements 


//name JOB 
/f EXEC PGME=IEBEDIT 

//SYSPRINT DD data set definition (output message) 
//SYSUTI DD data set definition (input data set) 
//SYSUT2 = -—DD data set definition (output data set) 


//SYSIN DD . 





"IEBEDIT control statements" 


f* 





Control Statements 


indicates which step or steps of a specified job in the input 
data set are to be included in the output data set. Any number 


of EDIT statements can be included in an operation, thus including 
selected jobs in the output data set, 





Format 


EDIT [START=jobname] 


POSITION 
TY PE=4 INCLUDE 
EXCLUDE 













[stername ({rome-none}L, {nme-ranel] 


[NOPRINT] 
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IEBGENER 


IEBGENER, a data set utility: 

Changes logical record length. 

Converts to partitioned, sequential data sets. 

Copies members. 

Copies sequential data sets. 

Edits and converts to partitioned, a sequential data set. 
Edits and copies a sequential data set. 

Expands a sequential data set. 

Prints a sequential data set. 

Reblocks a sequential data set. 





Return Codes 

00 - successful completion. 

04 - probable successful completion. A warning to the user is written. 

08 - processing was terminated after the user requested processing of 
user header labels only. 

12 - an unrecoverable error has occurred. The job step is terminated. 

16 - a user routine has passed a return code of 16 to the IEBGENER 
program. The job step is terminated. 





Job Control Statements 


//name JOB parameters 

i EXEC PGM=lEBGENER 

//SYSPRINT DD — data set definition (output message) 
//SYSUTI DD data set definition (input data set) 
J/SYSUT2 DD _—_ data set definition (output data set) 
//SYSIN DD parameters 


"IEBGENER control statements (when required)" 


ye 





Control Statements 








used to indicate the number of member names and alias 
names, record identifiers, literals, and editing information 
contained in the control data set. 


GENERATE 





EXITS used to indicate that user routines are provided. 


LABELS used to specify user- label processing. 

MEMBER used to specify the member name and alias of member of a = 
partitioned data set to be created. 

RECORD used to define a record group to be processed and to 
supply editing information. 
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IEBGENER (con’t) 


Conversion Table 


: Output length 
Code Conversion (input length =L) 


PZ Packed to unpacked decimal mode 2L-] 


ZP Unpacked to packed decimal mode (L/2)+C* 
HE | H-set BCD to EBCDIC mode 


* If Lis odd, C is 1/2; if Lis even, C is 1. 













_ 
















Note: PZ type (packed to unpacked) conversion is impossible for packed 
decimal records longer than 16K bytes. For ZP type (unpacked to packed 
conversion, the normal 32K byte maximum applies. 





If no conversion is specified, the field is moved to the output area without 
change. 





When the ZP parameter is specified, the conversion is performed in place. 
The original unpacked field is replaced by the new packed field. Therefore, 
the ZP parameter must be omitted from subsequent references to that field. 
If the field is needed in its original unpacked form, it must be referenced 
prior to the use of the ZP parameter. 






Format 





GENERATE [MAXNAME =n] 
[MAXFLDS=n] 
[MAXGPS =n] 
[MAXLITS =n] 


[INHDR = routinename] 
[OUTHDR =routinename] 
[{NTLR=routinename] 

[| OUTTLR = routinename] 
[KEY =routinename] 

[DATA =routinename] 
[LOERROR=routinename] 
[TOTAL =(routinename, size)] 



















DATA= ( YES 
NO 
ALL 


[label] | EXITS 
ONLY 


LABELS 
INPUT 


label MEMBER NAME =(namel,alias]...) 


5 RECORD 








IDENT = (length, 'name', input - location) 





FIELD =([length] , [input - location- or- 'literal'], [conversion], 
[output = location])... 


LABELS=n 
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IEBISAM 
IEBISAM, a data set utility: 


@ Converts to sequential, a partitioned data set. 
@ Copies an indexed-sequential data set. 

e Loads an indexed sequential data set. 

@ Unloads an indexed sequential data set. 





Return Codes 


00 - successful completion. 

04 - a return code of 04 or 12 was passed to the IEBISAM program by a user routine. 

08 - the program terminated operation because an error condition was encountered 
during processing. 

12 - a return code other than 00, 04, 08, or 12 was passed from a user routine to 
the IEBISAM program. The job step is terminated. 

16 - the program terminated operation because an error condition was encountered 
during processing. 





Job Control Statements 














PGMG=IEBISAM, PARM=| COPY 
UNLOAD 
LOAD 
[rain 
*PRINTLI, N1 [, EX!T=routinename]' 
//SYSPRINT DD data set definition (output messages) 
//SYSUTI = DD data set definition (input data set) 
//SYSUT2, DD data set definition (output data set) 


The PARM parameter on the EXEC statement is used to control the execution of 
IEBISAM. 


Control Statements 


The IEBISAM program is controlled by job control statements. 
No utility control statements are required. 
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IEBPTPCH 


IEBPTPCH, a data set utility: 


Edits and prints a sequential data set, 
Edits and punches a sequential data set, 
Prints a sequential data set. 

Prints partitioned data sets, 

Prints selected records, 

Punches a partitioned data set member, 
Punches a sequential data set. 

Punches selected records. 





Return Codes 





00 - indicates successful completion, 

08 - indicates that a member specified for printing does not exist in the 
input data set. Processing continues with the next member. 

12 = indicates that an unrecoverable error occurred or that a user routine 
passed a return code of 12 to IEBPTPCH. The job step is terminated. 

16 - indicates that a user routine passed a return code of 16 to IEBPTPCH. 
The job step is terminated. 





Job Control Statements 


//name JOB 
// EXEC PGM-IEBPTPCH 

//SYSPRINT DD data set definition (output message) 
//SYSUT1 DD data set definition (input data set) 
//SYSUT2 DD data set definition (output data set) 


//SYSIN DD * 


"IEBPTPCH control statements" 


7* 





Control Statements 


specifies that the data is to be either printed or punched. 


TITLE specifies that a title is to precede the printed or punched data. 





EXITS specifies that user routines are provided. 
MEMBER specifies that the input is a partitioned data set and that a 
selected member is to be printed or punched. 


RECORD specifies whether editing is to be performed, that is, records 
are to be printed or punched to non-standard specifications. 


LABELS specifies whether user labels are to be treated as data, 
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¥ 


IEBPTPCH (con't) 


Format 


[label] | PRINT [ PREFORM=A 
PUNCH | PREFORM=M. 
i TYPORG=PS \ 
ATYPORG=PCi 
TOTCONV=XE | Applicable to a PRINT or 
| | TOTCONV=PZ PUNCH operation. 

ICNTROL=n| 
[STRTAFT=n] 
[STOPAFT=n] 
[SKI P=n] 
[MAXINAME=n] 
[MAXFLDS=n] 
[MAX GPS=n] 
[MAXLITS=n] 
[INITPG=n] Applicable only to a PRINT 
[MAXLI NE=n] operation. 
[CDSEQ=n] Applicable only to a PUNCH 


[label] | TITLE ITEM=(‘title'[, output-location]) 


[label] | EXITS [INHDR=routinename] 


[I NTLR=routinename] 
[label] | MEMBER 


ILNREC=routinename] 
[label] | RECORD 


{OUTREC=routinename] 
[label] | LABELS 


Conversion Table 


Output Length 
Code Conversion (Where L is the Input Length) 
PZ Packed to unpacked decimal 2L-1 
mode 
XE Alphameric to hexadecimal 2L 
representation 










































{ NAME=membername \ 
NAME=aliasname 












IDENT=(length, 'name' , input-location)] 
FIELD=(length, [input-location], [conversion], 
[output-location])... 














DATA= ( YES 
NO 
ALL 
ONLY 
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IEBTCRIN 


JEBTCRIN, a data set utility: 


e@ Constructs records from MTST and MTD input. 
e Edits MTDI input. 
e@ Reads Tape Cartridge Reader input. 





Return Codes 


00 = normal termination. 
04 - warning message issued; execution permitted. Conditions leading to issuance 
of this code are: (1) SYSPRINT, SYSIN, SYSUT2, or SYSUT3 DD statements 
a missing and (2) DCB parameters missing in SYSUT2 or SYSUT3 DD statements. 
oy 12 - Diagnostic error message issued; execution terminated. Conditions leading to 
issuance of this code are: (1) SYSUT1 DD statement missing, (2) conflicting 
DCB parameters in DD statements, and (3) invalid or conflicting utility control 
statements. 

16 - Terminal error message issued; execution terminated. Conditions leading to 
issuance of this code are: (1) permanent input/output errors (not including 
data checks on the TCR), (2) unsuccessful opening of data sets, (3) requests 
for termination by user exit routine, (4) insufficient storage available for 
execution, and (5) user exit routine not found. 





Job Control Statements 


//name JOB 
/, EXEC PGM=IEBTCRIN 

//SYSPRINT DD data set reference (output messages) 

//SYSUT1 DD data set definition (input data set) 

//SXUT2 DD data set definition (output data set-valid records) 
//SYUT3 DD data set definition (output data set-error records) 


//SYSIN DD . 


"IEBTCRIN control statements" 


/* 





Special Purpose Codes 
MTD1I Ccdes 


x'00' (LZ) x'74! (P4) 
X11" (DUP) X'75! (P5) 
X'12'— (LZS) X'76' (P68) 
x'18" (CAN) X'77! (P7) 
X'ID' (GS) x'78' (PB) 


MTST Codes 


X'10' —s (er) X'51' (as) - 

X11" (sw) X'55! (AS) 

X13 (fd) X'80' (src) 
X'81'through X'FF! 





The special purpose codes listed are used by IEBTCRIN when constructing 
records. Use of these codes causes a message to be issued and the utility to 
be terminated. 
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IEBTCRIN (con’t) 


MTDI Codes from TCR 





Bit Positions 0,1 


Bit Positions 4, 5, 6, 7 
Second Hexadecimal Digit 

















Special Control: 

LZ = Left zero fill 
DUP = Duplicate 
LZS = Left zero s¥ 
ED = End Data 
GS = Group Separator 





























Start of Record (SOR): 
P] = Program level 1 
P2 = Program level 2 
P3 = Program level 3 
P4 = Program level 4 
P5 = Program level 5 
Pé = Program level 6 
P7 = Program level 7 
P8 = Program level 8 
CAN = Cancel 


End of Record (EOR): 
niche na nsceneeae eels RM = Record mor 


VOK= Verify OK 
































This figure represents the character set and control 
codes as read from an MTDI created cartridge. 
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IEBTCRIN (con’t) 


MTST Codes from TCR 


Bit Positions 0,1 





Bit Positions 2,3 


Bit Positions 4, 5, 6, 7 
Second Hexadecimal Digit 





First Hexadecimal Digit 


























crand CR = Carrier 
return code 
sw and SW = Switch code 
fd and FD = Feed code 
mole [o[efel oes 
tab and TAB = Tab code 
nen Oe ace ee 
search 
sp and SP = Space 
bsp and BSP = Backspace 
stx and STX = Stop transfer 
stc and SRC = Search 























This figure represents the character set and control 
codes as reod from an MTST created cartridge. 
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IEBTCRIN (con't) 


MIST Codes after Translation by IEBTCRIN 
with TRANS = STDCL 





Bit Positions 0,1 





Bit Positions 2,3 






Bit Position 4, 5, 6, 7 
Second Hexadecimal Digit 











ere TEE eet 
DUCSSeeeeOOGROoo 
ce 


ep CEEE CE GET pelelete 
pe 
piova) za) [Telefe esa 

jon} of | CER 
oof el | Tt tT def*fe? TT TT Tt 
ines ee I eee 
finale] [seq | [+t] [=| fe] TT TU 
Tin saa oe eeeeeee 


Note: The STDUC option permits translating 
both lowercase and uppercase alphabetic 
characters to uppercase, 


















TAB = Tab code 

CR = Corrier return 
BSP = Backspace 
SRC = Search 

STX = Stop transfer 
SP = Space 
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{EBTCRIN (con’t) 


Control Statements 


TCRGEN specifies whether MTDI or MTST input is to be processed and the 
a | type of processing to be performed. 
g EXITS specifies any exit routines provided by the user, 


Format 


[label] | TCRGEN _(MTDI 
[TvPe = Met 


































STDUC 

TRANS -22 DLC valid only with TYPE=MTST 
name specification. 
NOTRAN 










Valid only with TYPE=MTDI 
specification. 


EDITD 
[rows fer i 
NOEDIT. 


NOCHK 
VERCHK=) VOKCHk 





Valid only with TYPE=MTDI and either 
an EDIT=EDITD or EDIT=EDITR 
specification. 
[MINLN=n] Valid only with TYPE=MTDI and either 
an EDIT=EDITD or EDIT=EDITR 
specification. 








[MAXLN=n] Default=120 


[RePLAcE={% 17" Hl 














This operand is ignored if a user routine 
is specified for the ERROR operand in the 
EXITS utility control statement. 


[ron 








[ERROR=routine name] This exit is taken just prior to 
passing an error record to the 
error output data set (SYSUT3) 





[OUTREC=routine name] This exit is taken just prior to 


passing a record to the normal 
output data set (SYSUT2). 


[OUTHDR2=routine name] This exit is taken during the 
opening of the SYSUT2 data set. 
[OUTHDR3=routine name] This exit is taken during the 
opening of the SYSUTS3 data set, 
[OUTTLR2-routine name] This exit is taken during the 
closing of the SYSUT2 data set. 
[OUTTLRroutine name] This exit is taken during the 
closing of the SYSUT3 data set, 
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IEBUPDTE 


IEBUPDTE, a data set utility: 


Changes data set organization. 

Converts to partitioned, sequential data sets. 

Converts to sequential, a partitioned data set. 

Copies members. 

Copies sequential data sets. 

Creates a library of partitioned members. 

Deletes records in a partitioned data set. 

Edits and converts to partitioned, a sequential data set. 
Edits and copies a sequential data set. 

Enters a procedure into a procedure library. 

Includes changes to members or sequential data sets. 

Inserts records into a partitioned data set. 

Modifies a partitioned or sequential data set. 

Numbers records in a new member or in a partitioned data set. 
Prints a sequential data set. 

Reblocks a sequential data set. 

Renumbers logical records. 

Replaces logical records, members, records in a member, or 
records in a partitioned data set. 

Updates in place, a partitioned data set. 











Return Codes 


00 - indicates successful completion. 

04 - indicates that a control statement is coded incorrectly or used erroneously. 
If either the input or output is sequential, the job step is terminated. If 
both are partitioned, the program continues processing with the next 
function to be performed. 

12 = indicates an unrecoverable error. The job step is terminated. 

16 - indicates that a label-processing code of 16 was received from a user's 
label-processing routine. The job step is terminated. 


Job Control Statements 


//name JOB 

// EXEC aaa tells aus br [,inhdr ][,intlr]) 
MOD 

//SYSPRINT DD data set definition (output messages) 

//SYSUT1 DD data set definition (input data set) 

//SYSUT2 DD data set definition (output data set) 





//SYSIN DD ae 


of, "IEBUPDTE control statements" 
(optional data or label statements) 


/* 





w 
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{EBUPDTE (con’t) 


Function Statements 


A function statement is used to initiate the utility operation. At least one function 
statement must be provided for each member or data set to be processed. A function 
statement contains: 


=| 


ADD [ LIST=ALL] 
REPL [ SEQFLD =dd1] 
alla [ NEW=PO] Applicable to partitioned 
[ NEW=PS ] or sequential organization. 
[ MEMBER=ccccccce | 
[ COLUMN=dd ] 
[ UPDATE=INPLACE] 


REPRO 


[INHDR=cccccccc] 

[INTLR=ccececec] Applicable to sequential 
[OUTHDR=cccecece] organization only. 

[ OUTTLR=cececccec] 

[ TOTAL=(routinename, size) | 





[NAME=cccecccc] 
[ LEVEL=hh] Applicable to partitioned 


[ SOURCE=x] organization only. 
[SSl=hhhhhhhh] 





Detail Statements 


A detail statement is used with a function statement for certain applications, such as 
deleting or renumbering selected logical records. A detail statement contains: 


NUMBER] | [SEQI=ccccccce] Used with the NUMBER or 
DELETE {| [SEQ2=cccccccc] DELETE statement. 


[SEQI=ALL] 

[NEW l=cccecccc] Used only with the NUMBER 
[INCR=cececcec] statement. 

[INSERT=YES] 





Data Statement 


A Data Statement is used with a Function statement, or with a Function statement and 
a Detail statement. It contains a logical record used as replacement data for an exist 
ing logical record, or new data to be incorporated in the output master data set. 


Label Statement 


The LABEL statement indicates that the following data statements ure to be treated as 
user labels. These new user labels are placed on the output data set. The next Function 
statement indicates to IEBUPDTE that the last label data statement of the group has been 
read, 
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IEBUPDTE (con't) 
ALIAS Statement 


The ALIAS statement can be used with any of the function statements. Multiple alias 
names can be assigned to each member. The ALIAS statement contains: 


-/ | [label] | ALIAS NAME=ccccccee 


ENDUP Statement 


An ALIAS statement creates or retains an alias in an output (partitioned) master aie @ 








An ENDUP statement can be used to indicate the end of SYSIN input to this job step. 
It serves as an end-of-data indication if there is no other indication. The ENDUP 
statement follows the last group of SYSIN control statements and contains: 


[label] | ENDUP y 


JEHATLAS 
SEHATLAS, a system utility: 









Analyzes tracks on direct access. 

Assigns alternate tracks to a direct access volume. 

Gets alternate tracks on a direct access volume. 

Recovers data from defective tracks on direct access volumes. 
Replaces data on an alternate track. 


Job Control Statements 







//name 

tf EXEC PGMG=IEHATLAS 

//SYSPRINT DD data set reference (output messages) 

//SYSUTI DD data set definition (data set that contains the 
bad record) 

//SYSIN DD : 







"IEHATLAS control statements" 
/* 
Control Statements 

The utility control statement consists of either: 


TRACK=bbbbeccechhhhrrkkdddd{S] an 


or 


VTOC=bbbbcecchhhhrrkkdddd 


TRACK= 
specifies that an alternate track is to be assigned for a track that does 
not contain VTOC records. 








VTOC= 
specifies that an alternate track is to be assigned for a track that contains 
VTOC records. 


8-28 OS/VS Programmer’s Reference Digest 


IEHDASDR 
IEHDASDR, a system utility: 


Analyzes tracks on direct access. 

Assigns alternate tracks to a direct access volume. 

Changes the volume serial number of a direct access volume. 
Copies a direct access volume. 

Copies dumped data from tape to direct access. 

Dumps a direct access volume. 

Gets alternate tracks on a direct access volume. 

Initializes a direct access volume. 

Lists the contents of a direct access volume on a system 
output device. 

Restores a dumped direct access volume from tape. 

e@ Writes IPL records and a program on a direct access volume. 





Return Codes 


00 - indicates successful completion. 

04 = indicates that an unusual condition was encountered; 
however, the overall result is successful. A warning 
message is issued, 

08 - indicates that a specified operation did not complete success- 
fully. An attempt is made to perform any additional operations. 

16 = indicates that either an error occurred upon invoking IEHDASDR, 
or IEHDASDR was unable to open the input or message data set. 
The job step is terminated. 





Job Control Statements 


//name JOB 
rei PGM=IEHDASDR |, PARM='N=n' 

, PARM='LINECNT=xx! 

7 PARM='LINECNT=xx, NeEn! 
//SYSPRINT DD data set definition (output messages) 
//anyname DD data set definition (direct access device) 
//tapename DD data set definition (magnetic tape unit) 
J/SYSIN DD * 

"IEHDASDR control statements" 

f* 


The optional PARM information is used by the program to control line density 
on output listings, and to indicate the maximum number of operations of the 
same type that can be performed concurrently in the job step. 


LINECNT=xx 
specifies the number of lines per page in the listing of the SYSPRINT 
data set, The number xx is a 2=digit decimal number ranging from 
Ql to 99. 


specifies a decimal number from 1 to 6, The number represents the 
maximum number of like functions that can be performed concurrently 
by the IEHDASDR program. 





Control Statements 












ANALYZE used to analyze the recording surface to test for defective tracks, 
assign alternates for any defective tracks found, and format the 


volume to make it ready for use. 








FORMAT 





used to make a volume ready for use without performing an analysis 
of the recording surface. 


LABEL used to change the volume serial number of a direct access volume 
and, optionally, to update the owner field. 
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IEHDASDR (con’t) 


Control Statements (cont'd) 


GETALT used to assign an altemate track for a specified track. 
DUMP used to dump a single track, a group of tracks, or an 
entire direct access volume. 


RESTORE 


IPLTXT 
PUTIPL specifies that |PL records and a program are to be written 
on a direct access device. 


Format 


ANALYZE TODD=(cuu,...) 

TODD=(ddname,...) 
VTOC=xxxxx 

j 

[label] | LABEL 

NEWV OLID=serial 

[OWNERID=name] 


EXTENT=xxxxx 
[NEWVOLID=serial] 
{IPLDD=ddname] 
RAGTEST= | 
[label] | GETALT TODD=ddname 
TRACK=cecehhhh 
[label] | DUMP FRO MDD=ddname 
TODD=(ddname, ...) 
CPYVOLID=)YES | 
RESTORE 
PURGE= (YES 
NO 


NO 
NO 
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used to restore a previously dumped direct access volume 
to a direct access device. 









signals the beginning of IPL program text statements. 





























[NEWVOLID=serial ] 
[IPLDD=ddname] 
[OWNERID=name] 


ener TN 


TODD= { cuu } 


ddname 
































PASSES =({n 
| {of 
[OWNERID=name] 
PURGE=(\YES 
(NO 
TODD=(ddname,...) 
[BEGIN=ecechhhh] 
{END=ceechhhh] 
PURGE=\ YES 
NO 
TODD=(ddname,...) 
FROMDD=ddname 


VTOC=xxxxx 
EXTEN T=xxxxx 
CPYVOLID={ YES 
NO 






















IEHDASDR (con't) 


Format (cont'd) 


{label] | PUTIPL FROMDD=ddname 
TODD=ddname 


ae {ves\ 





PURGE=YES - Operator Replies 
Meaning 


All unexpired data sets on the volume can be overwritten. 


& ‘ (The operation continues. ) 


The volume contains unexpired data sets that must not be 
overwritten. (The operation is terminated.) 
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? 
IEHINITT 
IEHINITT, a system utility: 


e@ Labels magnetic tape volumes. 


Return Codes 


00 - successful completion. A message data set was created. 

04 - successful completion. No message data set was defined by the user. 

08 - the program completed its operation but error conditions were encountered 
during processing. A message data set was created, 

12 - the program completed its operation but error conditions were encountered 
during processing. No message data set was defined by the user. 

16 = the program terminated operation because of error conditions encountered 


while attempting to read the control data set. A message data set was 
created if defined by the user, 








Job Control Statements 


//name JOB 
EXEC PGMGIEHINITT[, PARM=LINECNT=nn] 
//SYSPRINT DD data set definition (sequential output) 


//anyname DD data set definition (tape unit-labeling) 
//SYSIN DD * 


"INITT control statement (s)" 
/* 





The optional PARM information on the EXEC statement specifies the number 
of lines to be printed between headings in the message data set. 





Control Statements 


The IEHINITT program uses an INITT utility control statement to provide control 
information for a labeling operation. Any number of INITT utility control statements 
can be included for a given execution of the program. An identically named DD 
statement must exist for a utility control statement in the job step. 


Format 


: 







SER=xxxxxx 

[OWNER=' ceeccecece[cece]'] 

[NUMBTAPE=n] 

{ DISP=REWIND \ 
DISP=-UNLOAD 

[LABTY PE=AL 














8-32 OS/VS Programmer’s Reference Digest 


IEHIOSUP 


JEHIOSUP, a system utility (VS1 only): 
e@ Updates TTR entries in the supervisor call library. 
& Return Codes 


00 - successful completion. 
12 - an unrecoverable error has occurred. The job step is terminated. 


Job Control Statements 


//name JOB 
EXEC PGM=IEHIOSUP 
//SYSUTI DD data set definition (object data set - SYS1.SVCLIB) 





//SYSPRINT DD data set definition (output messages) 
* 





Control Statements 





IEHIOSUP is executed or invoked with job control statements. No 
utility control statements are required. 
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IEHLIST 
IEHLIST, a system utility: 


e Lists a volume table of contents. 
e Lists partitioned directories. 
e Lists the contents of the catalog (SYSCTLG) data set. 





Return Codes 


00 - successful completion. 

08 - due to an error condition, a specified request was ignored. 
Processing continues. 

12 - indicates that a permanent input/output error occurred. The job 
is terminated, 

16 ~ indicates that an unrecoverable error occurred while reading the 
data set. The job is terminated. 





Job Control Statements 








//name JOB parameters 







EXEC PGM=IEHLIST[, PARM='LINECNT=xx' ] 
//SYSPRINT DD data set definition (output message) 
//anynamel DD data set definition (permanently mounted volume) 
/fanyname2 DD data set definition (mountable device type) 
//SYSIN DD * 





"IEHLIST control statements" 





/* 


The optional PARM information on the EXEC statement specifies the number 
of lines to be printed per page. The value of xx is a decimal number from 01 
through 99, 







Control Statements 


LISTCTLG used to request a listing of all or part of a catalog. 
LISTPDS used to request a directory listing of one or more partitioned 
data sets. 





LISTVTOC used to request a listing of all or part of a volume table of 
contents. 


Format 


LISTCTLG [VOL=device=serial ] 
[NODE=name] 


[label] | LISTPDS DS NAME=(name[, name]. ..) 
[VOL=device=serial] 
[label] | LISTVTOC 


DUMP 
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FORMAT 








DUMP 
FORMAT 
[BATE=dddyy] 
[VOL=device=serial ] 
[DSNAME=(name[, name]... ) 







IEHMOVE 
IEHMOVE, a system utility: 


Copies a catalog. 

Copies a direct access volume. 

Copies a partitioned data set. 

Copies a volume of data sets. 

Copies cataloged data sets. 

Copies selected members. 

Copies sequential data sets. 

Excludes a partitioned data set member from a copy operation. 
Merges partitioned data sets. 

Moves a catalog. 

Moves a volume of data sets. 

Moves cataloged data sets. 

Moves partitioned data sets. 

Moves sequential data sets. 

Renames moved or copied members. 

Replaces selected members in a move or copy operation. 
Unloads a partitioned data set. 

Unloads a sequential data set. 


Return Codes 

00 ~ successful completion. 

04 - a specified function was not completely successful. Processing continues. 

08 - a condition has occurred from which recovery is possible. Processing 
continues. 

12 ~an unrecoverable error has occurred. The job step is terminated. 





Job Control Statements 


//name JOB parameters 
EXEC PGM=IEHMOVE |, PARM= ('POWER=n!' 
"POWER=n,LI NEcNTon 

"LINECNT=xx' 

//SYSPRINT DD data set definition (output message) 

//SYSUT1 DD data set definition (work data set) 

//anynamel DD data set definition (permanently mounted volume) 

/fanyname2 DD data set definition (mountable device type) 

//tape DD data set definition (tape volume) 

//SYSIN DD = 

"IEHMOVE control statements" 
/* 


The optional PARM information in the EXEC statement is used to allocate 
additional work space and/or control line density on output listings. 





The POWER=n parameter is used to request that the norma! amount of space 
for work area is to be increased n times. 


The LINECNT=xx parameter specifies the number of lines per page in the 
listing of the SYSPRINT data set. 





Control Statements 


COPY DSNAME used to copy a data set. 
MOVE DSGROUP used to move a group of cataloged data sets. 


COPY DSGROUP 
MOVE PDS 













used to copy a group of cataloged data sets. 






used to move a partitioned data set. 
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IEHMOVE (con't) 


Control Statements (cont'd) 


COPY PDS used to copy a partitioned data set. 
COPY CATALOG used to copy cataloged entries. 


MOVE VOLUME used to move a volume of data sets. 
COPY VOLUME used to copy a volume of data sets. 


In addition, there are four subordinate control statements that can be used to modify 
the effect of a MOVE or COPY DSGROUP, MOVE or COPY PDS, or MOVE or COPY 
CATALOG operation, The subordinate statements and the control statements with 
which they can be combined are shown in the following table: 













Valid Combinations of Control Statements 


Subordinate Statements 


INCLUDE ; 
EXCLUDE 






Utility Statements 








MOVE DSGROUP 
or 


COPY DSGROUP 












INCLUDE 
EXCLUDE 
REPLACE 

SELECT 






MOVE PDS 
or 


COPY PDS 













MOVE CATALOG 
or 


COPY CATALOG 


EXCLUDE 














Format 


[label] | MOVE DS NAME=name 


TO=device=list 
COPY 





[ FROM=device=list | 
CVOL=device=serial 
[UNCATLG] 
[RENAME=name] 
[FROMDD=ddname]} 
[TODD=ddname] 





DSNAME=name 
TO=device=list 
ayeediem ist | 
CVOL=device=serial 
[UNCATLG] 
[CATLG] 
[RENAME=name] 
{FROMDD=ddname] 
{TODD=ddname] 























DSGROUP [=name] 
TO=device=list 
[CVOL=device=serial | 
[PASSWORD] 
[UNCATLG] 
[TODD=ddname] 
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IEHMOVE (con’t) 


Format (cont’d) 


[label] COPY DSGROUP [=name] 
TO=device=list 
[CV OL=device=serial | 
[PASSWORD] 
{UNCATLG] 
(CATLG] 
[TODD=ddname] 

[label] MOVE PDS=name 
TO=device=serial 
oe ] 
CVOL=device=serial 
[EXPAND=nn] 
[UNCATLG] 
[RENAME=name] 
[FROMDD=ddname]} 
{TODD=ddname] 

[label] COPY PDS=name 
TO=device=serial 
Poonam | 
CVOL=device=serial 
[EXPAND=nn] 
[UNCATLG] 
[CATLG] 
{RENAME=name] 
[FROMDD=ddname] 
[TODD=ddname] 


[label] MOVE CATALOG [=name] 
TO=device=serial 
PAveieentel 
FROM=device=serial 
[FROMDD=ddname] 
[TODD=ddname] 


[label] COPY CATALOG [Ename] 
TO=device=serial 
Sete iatiaalie | 
FROM=device=serial 
[FROMDD=ddname] 
[TODD=ddname] 

[label] MOVE VOLUME=device=serial 
TO=device=list 
[PASSWORD] 
[TODD=ddname] 

[label] COPY VOLUME=device=serial 
TO=device=list 
[PASSWORD] 
[CATLG] 
(TODD=ddname] 


INCLUDE DS NAME=name 
| MEMBER=membername] 
Ped oe ist | 
CV OL=device=serial 


[label} EXCLUDE { DS GROUP=name } 
MEMBER=membername 


[label] SELECT MEMBER=(namel,name]...) 


MEMBER=((name, newname)|, (name, newname)]...) 





[label] REPLACE DSNAME=name 
MEMBER=membemame 
Paeralomede ] 
CVOL=device=serial 





Section 8: OS/VS Utilities 8-37 





f - 


IEHPROGM 
IEHPROGN, a system utility: 


Adds a password. 

Builds a generation-data-group index. 
Builds a generation. 

Builds an index. 

Catalogs a data set. 

Catalogs a generation data set. 

Creates an index. 

Deletes a password. 

Deletes an index structure. 

Lists a password entry. 

Password-protects add, delete, or lists password operations. 
Renames a partitioned data set member. 
Renames a sequential or partitioned data set. 
Scratches a volume table of contents. 
Scratches data sets. 

Uncatalogs data sets. - 








Return Codes 


00 = successful completion. 

04 - a syntax error has been found in the name field of the control card. 
Processing is continued. 

08 - a request for a specific operation has been ignored because of an 
invalid control statement or an otherwise invalid request. The 
operation is not performed, 

12 - an I/O error has been detected when trying to read or write from 
or onto SYSPRINT, SYSIN or the VTOC. 

16 = an unrecoverable error has occurred. The job step is terminated. 





Job Control Statements 


//name JOB parameters 


If EXEC PGM=IEHPROGM |, PARM='LINECNT=xx J,PRINT 
NOPRINT 
//SYSPRINT DD data set definition (output message) 


//anynamel DD data set definition (permanently mounted volume) 
//anyname2 DD data set definition (mountable device type) 
//SYSIN DD * 


"IEHPROGM control statements" 
/* 
The optional PARM information on the EXEC statement is used to control the 
number of lines per page on the output listing and to suppress printing of 


utility control statements, The value xx is a 2-digit decimal number from 
01 through 99, 





Control Statements 


SCRATCH | used to delete a data set or member. from a direct access volume, 


RENAME | used to change the name or alias of a data set or member residing 
on a direct access volume. 
CATLG used to generate an entry in the index of a catalog. 


UNCATLG| used to remove an entry from the lowest level index of the catalog. 
BLDX used to create a new index in the catalog. 


DLTX used to remove a low level index from the catalog. 
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IEHPROGM (con’‘t) 


Control Statements (cont'd) 


BLDA used to assign an alias previously assigned to an index at the 
highest level of the catalog. 

DLTA used to delete an alias previously assigned to an index at the 
highest level of the catalog. 

CONNECT) used to place an entry into an index at the highest level of 
the catalog. 

RELEASE | used to remove an entry from the highest level index of a 
volume. 

BLDG used to build an index for a generation data group and 
establish the action to be taken should the index overflow. 


used to add a password entry into the PASSWORD data set. 


REPLACE 



















used to replace information in a password entry. 


DELETEP 





used to delete an entry in the PASSWORD data set. 


LIST 


used to format and list information from a password entry. 








Format 


SCRATCH pears 
VTOC 

VOL=device=list 
[PURGE] 
[MEMBER=name] 
[SYS] 

RENAME DS NAME=name 
VOL=device=list 
NEW NAME=name 
[MEMBER=name] 


CATLG DSNAME=name 
VOL=device=list 
[CV OL=device=serial | 
[label] | UNCATLG DS NAME=name 
[CVOL=device=serial |] 
BLDX INDEX=name 
[CVOL=device=serial ] 
DLTX INDEX=name 
[CV OL=device=serial | 
BLDA INDEX=name 
ALIAS=name 
[CV OL=device=serial ] 
DLTA ALIAS=name 
[CV OL=device=serial | 
CONNECT i NDEX=name 
VOL=device=serial 
[CVOL=device=seria] | 
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IEHPROGM (con't) 


Format (cont'd) 


{label] | RELEASE INDEX=name 
[CV OL=device=serial ] 






























[label] | BLDG INDEX=name 
ENTRIES=n 
[(CVOL=device=serial |] 
[EMPTY] 
[DELETE] 


DS NAME=name 
[PASWORD2=new-password] 
{CPASWORD=cortrol-password] 
[TY PE=code] 
[VOL=device=list] 
[DATA="'user-data' | 











- 





DS NAME=name 
[PASWORD 1=current-passwo rd] 
[PASWORD2=new-password] 

[CPASWORD=control-password] 
[TY PE=code] 
[ 
[ 















VOL=device=list] 
DATA='user-data’ ] | 


DS NAME=name 
[PASWORD1=current-password] 


[label] | REPLACE 
[CPASWORD=centrol-password] 


[label] | DELETEP 
[VOL=device=list] 
LIST DS NAME=name 
PASWORD1=current-password 


IEHSTATR 








IFHSTATR, a system utility: 


e Edits and lists error statistics by volume (ESV) records. 





Job Control Statements 


JOB 
EXEC PGM=|IFHSTATR 
J/SYSUTI DD data set definition (input data set) 


ee DD  _. data set definition (output data set) 
* 





Control Statements 


IFHSTATR is controlled by job control statements. Utility control statements are 
not used. 
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Definition of Operands 


ACTION= 


ADDLABEL= 


BY PASS= 


CATALOG 


CDINCR= 


CHARACTER= 


action 


ecechhhh 


[=name| 


character 


specifies that the contents of a defined 
field are to be altered after the field's 
inclusion in an output record, 


specifies the channel number, c, and unit 
number, uu, of the 3211. 


specifies the total number of additional 
labels for which space is to be allocated. 
The value can be | through 7. 


specifies an unqualified name to be assigned 
as the alias, or specifies the unqualified name 
of the index alias to be deleted. 


specifies in hexadecimal a cylinder number, 
ccec, and head number, hhhh, that identifies 
the first track to be dumped. 


specifies a one~ to five-byte reltative track 
address that identifies the first track to be 
dumped. 


specifies that no check is to be made for 
defective tracks. 


specifies the catalog entries to be moved 
or copied, 


specifies that the copied data set(s) is to 
be cataloged on its receiving volume(s) 
if it is a direct access volume. Ifa 
catalog does not exist on the receiving 
volume, it is created. 


specifies the increment to be used in 
generating sequence numbers. If 
CDINCR is omitted and CDSEQ is 
coded, 10 is assumed as an increment 
value for sequence numbering. 


specifies the initial sequence number of a deck 
of punched cards. 


specifies the starting character of a field. 


specifies a control character for the output device 
that either indicates line spacing, or is used to select 
the stacker as follows: 1 indicates single spacing or 
first stacker; 2 indicates double spacing or second 
stacker; and 3 indicates triple spacing. 
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Definition of Operands (con't) 


COLUMN= dd specifies, in decimal, the starting column of a data 
field within a logical record image. The field extends 
to the end of the image. Column is valid only when 
CHANGE is coded. 


CPASWORD= __control- specifies the control password for the data set. 
password 


CPYVOLID= specifies that all receiving or restored direct access 
volumes are to be assigned the serial number of the 
dumped volume. 


specifies that receiving or restored volumes are to 
keep their own serial numbers. 


device= specifies the device type and volume serial number 
serial of the volume, catalog entry, or index to be operated 
upon. 


specifies a number of output records that are treated 
as a group by the INDEX keyword. 


specifies that user labels are to be treated as data 
regardless of any return code. 


specifies that user labels for the output data set are 
supplied as 80 byte input records in the data portion 
of SYSIN, 


specifies that user labels are not to be treated as data. 


specifies that only user header labels are to be treated 
as data. 


routinename specifies the symbolic name of a routine that modifies 
the physical record before it is processed by IEBGENER. 


‘user-data' specifies that user data is to be included in the pass- 
word entry. The user data must be in single quotes 
and must not exceed 77 characters. 


specifies that any user labels that are not rejected by 
a user's label processing routine are to be treated as 
data. 


specifies that each entry that expires before this date 
is to be flagged with an asterisk(*) in the listing. 


DELETE specifies that generation data sets are to be scratched 
after their entries are removed from the index. 
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DSGROUP 


DS NAME= 


ENTRIES= 


ERRORT= 


EXPAND= 


EXTENT= 


FIELD= 


REWIND 


UNLOAD 


(name[,name]...) 


EDITR 


NOEDIT 


ecechhhh 


NORMAL 


NOERR 


routinename 


roufinename 





conversion 


specifies that a tape is to be rewound (but not unloaded) 
after the label has been written. 


specifies that a tape is to be unloaded after the label 
has been written. 


specifies a qualified name. 
specifies the cataloged data sets to be processed. 


specifies the fully qualified name of the data set to be 
processed, 


specifies the fully qualified names of the data sets whose 
directories or entries are to be listed. 


specifies that the listing is to be in unedited, hexa- 
decimal form. 


specifies that the input is to be edited and that SOR 
and EOR codes are to be deleted and not included as 
part of the output record. 


specifies that the input is to be edited and SOR and 
EOR codes are to be kept as part of the output record. 


specifies that no editing is to be performed. 


specifies that all entries be removed from the 
generation-data-group index when it overflows. 


specifies,in hexadecimal, a cylinder number, cccc, 
and head number, hhhh, that identify the last track to 
be dumped. 


specifies the relative track address of the last track 
to be dumped. 


specifies the number of entries to be contained in the 
generation-data-group index; n must not exceed 255. 


specifies that all error records are to be placed in the 
error data set (SYSUT3). 


specifies that all records (including error records) are 
placed in the normal output data set (SYSUT2). No 
records are placed in the error data set (SYSUT3). 


specifies the symbolic name of a routine that is to 
receive control for error handling. 


specifies the name of a user routine that is to receive 
control from |EBDG before writing each output record. 


specifies the number of 256-byte records (up to 99 
decimal) to be added to the directory of the specified 
partitioned data set. 


specifies the length (number of tracks) of the VTOC. 
specifies the decimal length of the VTOC in tracks. 


specifies a tworbyte code that indicates the type 
of conversion to be performed on this field. 
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FIELD= input- 


(cont'd) location 


length 
‘literal’ 
output=~ 
location 
‘character' 


X'2 hex-digits' 


FLAGTEST= 


pattern 


FORMEND= 


device= 
list 


device= 
serial 
FROMADDR= 
FROMDD= ddname 
FROMDEV= 


FROMLOC= number 


input- 
location 


specifies the starting byte of the field to be processed. 


specifies the length (in bytes) of the input field or 
literal to be processed. 


specifies a literal (maximum length of 40 bytes) to be 
replaced in the specified output location. 


specifies the starting location of this field in the out- 
put records, 


specifies an EBCDIC character to be placed in each 
byte of the defined field or output record. 


specifies two hexadecimal digits to be placed in each 
byte of the defined field or output record. 


specifies that the program is not to check for previously 
flagged tracks on this volume. 


specifies that each track is to be checked to see if it 
was previously flagged as defective. 


specifies that lower case letters are not to be printed 
as upper case letters. 


specifies that lower case letters are to be printed as 
upper case letters when the lower case print train is 
not available. 


specifies that the listing is to be edited for each 
directory entry, or that a comprehensive edited 
listing is to be generated. 


specifies an IBM-supplied pattern that is to be placed 
in the defined field. FORMAT= must not be used 
when PICTURE is used. 


specifies the number of lines (max. 180) on the 
printer form. For an 11 inch form, spacing six 
lines per inch, x must be 66. 


specifies the volume or volumes on which the data 
set currently resides, if it is not cataloged. 


specifies the device type and volume serial number 
of the volume to be processed. 


specifies channel number, ¢, and unit number, uu, 
of the source device. 


specifies the ddname of the DD statement defining 
the device that contains the appropriate input data. 


specifies the type of the source device, for example, 
3330 or 2400. 


specifies the location of the selected field within the 
input logical record. 


specifies the starting location of the field that con- 
tains the identifying name in the input records. 
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IDENT= 
(cont'd) 


INITPG= 


INPUT= 


INSERT= 


IOERROR= 


IPL= 


IPLDD= 


length 


ececcecce 


cecceccc 


routinename 


ddname 
(ddname,...) 


SYSIN[(cece)} 


routinename 


eccccece 


routinename 


routinename 


YES 


ddname 





specifies the length (in bytes) of the identifying 
name of the last record of the input group to which 
the FIELD parameters or member statement applies. 
The length cannot exceed eight characters. 


specifies the exact literal that identifies the last 
record of a record group. 


specifies the increment value used for assigning 
successive sequence numbers to new or replace- 
ment logical records, or specifies an increment 
value used for renumbering existing logical records, 


specifies the ddname which is indicated on a DD 
statement of an input data set. 


speciries that all members to be copied or loaded 
from this input data set are to replace any identi- 
cally named members on the output partitioned 
data set, 


specifies the qualified name of the index to be 
processed, or specifies the unqualified index name 
to be acted upon, 


specifies a number to be added to this field when~ 
ever a specified number of records have been 
written, 


specifies the symbolic name of a user routine that 
handles any user input (SYSUT1) header labels. 


specifies the symbolic name of a routine that 
processes user input header labels. 


specifies the initial page number; the pages are 
numbered sequentially thereafter. 


specifies the ddname of a DD statement defining 
a data set used as input to the program. 


specifies that the SYSIN data set contains records 
(other than utility control statements) to be used 
in the construction of output records. 


specifies the symbolic name of a routine that 
manipulates each logical record before it is 
processed, 


specifies the insertion of a block of logical 
records, 


specifies the symbolic name of the user routine 
that handles input (SYSUT1) trailer labels. 


specifies the symbolic name of a routine that 
processes user input trailer labels. 


specifies the symbolic name of a routine that 
handles permanent |/O error conditions. 


specifies that an IPL program is to be written on 
the volume. 


specifies the ddname of a DD statement defining 


the data set containing the IPL program. 
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LABELS= 


LABTYPE= 





LENGTH= 


output- 
location 


‘title’ 


specifies the starting position at which a literal 
for this item is to be placed in the output record. 


specifies the title or subtitle literal (maximum 
length of 40 bytes), enclosed in apostrophes. 





routinename 





MAXFLDS= 


MAX GPS= 


MAXLINE= 


MAXLITS= 


specifies the symbolic name of a routine that 
creates the output record key. 


indicates the number of records in the SYSIN data 
set to be treated as user labels. The number n 

is a number from 1 to 8. If this parameter is 
included, DATA=INPUT must be coded on a LABELS 
statement before it is in the input stream. 


specifies that an ANS volume label is to be created. 


specifies the length in bytes of the defined field. 


specifies the change (update) level in hexadecimal 
(00-FF). This parameter is valid only when a 
member of a partitioned data set is being processed. 


specifies that the SYSPRINT data set is to contain 
the entire updated member or data set and the con- 
trol statements used in its creation. 


specifies that the names of copied members are not 
to be listed on SYSPRINT at the end of each input 
data set. 


((l,c)[,(1,¢,)...])specifies the channels of the FCB image. Each set 


of parentheses must contain the line number (1-280), 
a comma, and the channel number (1-12) to be 
assigned to that line. One or ail of the 12 channels 
may be assigned in any order. Each set must be 
separated by commas and the entire group surrounded 
by parentheses, 


specifies that six lines per inch will be printed. 
specifies that eight lines per inch will be printed. 


specifies a number that is no less than the total num- 
ber of FIELD parameters appearing in subsequent 
RECORD statements. MAXFLDS is required if there 
are any FIELD parameters in subsequent RECORD 
statements. 


specifies a number that is no less than the total 
number of IDENT parameters appearing in subsequent 
RECORD statements. MAXGPS is required if there are 
any IDENT parameters in subsequent RECORD state- 
ments, 


specifies the maximum number of lines to a printed 
page. Spaces, titles, and subtitles are included in 
this number, 


specifies a number that is no less than the total 
number of characters contained in the FIELD or IDENT 
literals of subsequent RECORD statements. 


specifies the number of bytes, plus four for the record 
descriptor word when variable records are specified, 
to be contained in all but the last record passed to 
the output routine when editing is not performed. 
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MAX NAME= 


MEMBER= 


ecccccce 


membername 


specifies a number that is no less than the total 
number of member names and aliases appearing in 
subsequent MEMBER statements. MAXNAME is 
required if there are one or more MEMBER state- 
ments. 


specifies a name to be assigned to the member 
placed in the partitioned data set defined by the 
SYSUT2 DD statement. 


specifies the name of a member of the partitioned 
data set named in the DSNAME parameter, or 
identifies a member to be excluded from the parti- 
tioned data set being moved or copied when the 
EXCLUDE statement modifies a MOVE partitioned 
data set or COPY partitioned data set statement. 


[(] membername1[,membername2]... [)] 


specifies members on the input data set that are not 
to be copied, unloaded, or loaded to the output data 
set. The members are not deleted from the input data 
set unless the entire data set is deleted. 


specifies the name or alias for a member (in the named 
data set) that is to be processed. 


(name[,name]...) identifies the members to be moved or copied. 


((name,newname)([, (name,newname)]...) 


newname 


R 


aliasname 
cceccece 
membername 


name 
(namel,...) 


identifies the members to be moved or copied and 
gives the new name for each member. 


specifies a newname for a selected member. 


specifies that the input member is to replace any 
identically named member that exists on the output 
partitioned data set, The replace option is not 
valid for an unload operation. 


specifies the byte length of the shortest valid edited 
record, 


specifies the bit density for data written onto the 
receiving magnetic tape volume. 


specifies a decimal model number (1 or 2) for the 
2305. 


indicates the name of the member placed in the 
partitioned data set, or specifies a one- to eight- 
character alias depending on the operation. 


specifies a member by its member name. 


(namel,namen,..) 
(name, (COPY=namel,namen...)..-) 





specifies the name of the field defined by this FD 
statement, or specifies the name(s) of a field(s) to 
be included in the applicable output records. (cont'd) 
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Continued from COPY indicates that all fields named in the inner 
preceding page parentheses (maximum of twenty) are to be treated 
as a group and included the specified number of 

times in each output record. 


(name[,alias]...) specifies a member name followed by a list of its 
aliases. 


specifies that the old master data set is a sequential 
data set, and that the updated output is to become 
a member of a partitioned data set. 


specifies that the old master data set is a partitioned 
data set, and that a member of that data set is to be 
converted into a sequential data set. 


NEWNAME= name specifies the new fully-qualified name for the data 
set, or the new member of alias. 


NEW1= ecccecce specifies the first sequence number assigned to new 
or replacement data, or specifies the first sequence 


number assigned in a renumbering operation. aaa 





| NEWVOLID= 





serial specifies a one- to six-character volume serial 


number. 


NODE= name specifies a qualified name. 


NOPRINT specifies that the message data set is not to include 
a listing of the output data set. 











NUMBTAPE= 






n specifies the number of tapes to be labeled according 
to specifications made in this control statement. The 
value n represents a number from 1 to 255. 


OUTDD= ddname specifies the name of the output partitioned data set. 













OUTHDR= ceccccec specifies the symbolic name of the user routine that 
handles any user output (SYSUT2) header labels. 


routinename specifies the symbolic name of a routine that creates 
user output header labels. 





OUTHDR2= routinename specifies the symbolic name of a routine that receives 
control during the opening of the SYSUT2 data set. 


OUTHDR3= routinename specifies the symbolic name of a routine that receives | 
control during the opening of the SYSUT3 data set. 


OUTPUT= (ddname) specifies the ddname of the DD statement defining the 
output data set. 


routinename specifies the symbolic name of a routine that mani- 
pulates each logical record before it is printed or 
punched, or specifies the symbolic name of a routine 
that receives control before the record is passed to 


the normal output data set (SYSUT2). 


eccecece specifies the symbolic name of the user routine that 
handles any user output (SYSUT2) trailer labels. 


routinename specifies the symbolic name of a routine that 
processes user output trailer labels. 





OUTTLR2= routinename specifies the symbolic name of a routine that receives 
control during the closing of the SYSUT2 data set. 
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OUTTLR3= 


OWNERID= 


PASSES= 


PASSWORD 


PASSWORD 1= 


PASSWORD2= 


PICTURE= 


PRECOMP= 


PREFORM= 


routinename 


specifies the symbolic name of a routine that receives 
control during the closing of the SYSUT3 data set. 


‘eccceccecc[cece]' 


XXXARARKAXKX 


current= 
password 


new=password 


B'decimal number' 


‘character string' 


length 


p'decimal number' 


startloc 


routinename 





specifies the owner's name or similar identification. 
The information is specified as character constants, 
and can be up to 10 bytes in length for EBCDIC and 
BCD volume labels, or up to 14 bytes in length for 

ANS volume labels. 


specifies a one to ten-character name or other 
identifying information. OWNERID is specified as 
an EBCDIC character string with the exclusion of the 
blank and the comma characters. 


specifies a one- to ten-character field that identifies 
the owner of the volume. 


specifies the number of passes to be made in analyzing 
a recording surface. 


specifies that the ANALYZE function is to bypass all 
surface analysis and track formatting, writing only a 
a VTOC, track zero records (IPL bootstrap and volume 
label records), and IPL text if requested. 


specifies that password protected data sets contained in 
the group are to be included in the operation. 


specifies the current password in the entry to be includ- 
ed in the operation. 


specifies the new password to be assigned to the entry. 
The password can consist of one- to eight-alphameric 
characters. 


specifies the fully qualified name of the partitioned 
data set to be moved or copied, 


specifies a decimal number that is to be converted to 
binary and right-aligned in the defined field. 


specifies an EBCDIC character string that is to be 
placed in the defined field or applicable records. 


specifies the number of bytes the picture will occupy. 


specifies a decimal number that is to be converted to 
packed decimal and right-aligned in the defined field. 


specifies a starting byte (within any applicable out- 
put record) in which the picture is to begin. 


specifies the symbolic name of a routine that processes 
logical records (physical blocks in the case of VS or 
VBS records longer than 32K bytes) from either or 

both of the input data sets before they are compared. 


specifies that an ASA control character is provided 


as the first character of each record to be printed or 
punched, 
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PREFORM= M specifies that a machine~code control character is 
(cont'd) provided as the first character of each record to be 
printed or punched, 


specifies that each data set specified by DSNAME d - 
VTOC be scratched, even if its expiration data has 
not elapsed, 


indicates that all unexpired data sets on the volume 
can be overwritten provided that the operator signals 
his concurrence when the first unexpired data set is 
encountered, or that the program may be written ovefed 
any user labels, or over any data that follows the 23 
volume label record. 


specifies that the operation is to be terminated if an 
unexpired data set is encountered, or specifies that 
the program may not be written over standard user 
labels. 


QUANTITY= — number 
number[, CREATE=number] 


specifies the number of records that this statement is 
to generate (each record is specified by the other 
parameters), or specifies the number of times the 
defined group of CREATE statements is to be used 
repetitively. 


CREATE specifies the number of following CREATE 
statements to be included in the group. 


RANGE= specifies an absolute value which the contents 
of this field can never exceed. 


RENAME= specifies that the data set is to be renamed, and 
indicates the new name. 


REPLACE= specifies the hexadecimal representation of the 
character to be used by IEBTCRIN to replace error 
bytes. 


SEQFLD= specifies, in decimal, the starting column (up to 
column 80) and length (8 or less) of sequence numbers 
within existing logical records and subsequent Data (aus 
statements. 


cceeccce specifies the sequence number of the first logical 
record to be renumbered or deleted. 


ALL specifies a renumbering operation for the entire 
member or data set. 


cececece specifies the sequence number of the last logical 
record to be renumbered or deleted. 


specifies the volume serial number of the first or 
only tape to be labeled. 


specifies a mathematical sign (+ or -), which is 
used when defining a packed-decimal or binary 
field. 


specifies that every nth record is to be printed 
or punched. 
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SOURCE= specifies user modifications when the x value is 0, 
or IBM modifications when the x value is 1. This 
parameter is valid only when a member of a 


partitioned data set is being processed. 


hhhhhhhh specifies eight hexadecimal characters of system 
status information to be placed in the directory 
of the new master data set as four packed hexa- 

decimal bytes of user data. 




























jobname specifies the name of the input job to which the 


EDIT statement applies. 








F'®T ARTLOC= starting-byte specifies a starting location (within all output 
location records using this field) in which a field is to 
begin. 


STEPNAME= name specifies the first job step to be placed in the output 
data set when coded with TYPE=POSITION. Job 
steps preceding this step are not copied to the output 
data set. When coded with TYPE-INCLUDE or 
TYPE=EXCLUDE, STEPNAME specifies the names of 
job steps that are to be included in, or excluded 
from, the operation. 


STOPAFT= n specifies, for sequential data sets, the number of 
logical records to be punched or printed. For parti- 
tioned data sets, this specifies the number of logical 
records to be punched or printed in each member to 

be processed. 


STRTADR= nnnnn specifies the one- to five-byte track address, relative 
to the beginning of the volume, at which the VTOC 
is to begin. 


STRTAFT= n specifies, for sequential data sets, the number of logi- 
cal records to be skipped before printing or punching 
begins. For partitioned data sets, STRTAFT=n speci- 
fies the number of logical records to be skipped in 
each member before punching begins. 


specifies that data sets that are to be scratched have 
names that begin with "“AAAAAAAA, AAAAAAAA. 
AAAAAAAA. AAAAAAAA." or "SYSnnnnn.T" and 
“E" or "V" in position 19, These names are assigned 
to data sets by the operating system. 











specifies the volume(s) to which the data set(s) is to 
be moved or copied. 


TO= device= specifies the device type and volume serial number of 
serial the volume to which the partitioned data set or 
cataloged entries are to be moved or copied. 


specifies the channel number, c, and unit number, uu, 
of the message output or receiving device. 















specifies the channel and unit address of the direct 


(cuu,...) access device containing the volume to be processed. 


ddname specifies the ddname of a DD statement defining the 
(ddnome,...) device that contains the volume to be processed. 


Wi ovev= XXXX specifies the type of output or receiving device, for 
example, 2400. 
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routinename 


size 


TOTCONV= 


ecechhhh 


NOTRAN 


STDLC 


EXCLUDE 


INCLUDE 


MTDI 
MTST 


POSITION 


TYPORG= 





UNCATLG 


UPDATE= INPLACE 


8-52 


specifies the name of the user's totaling routine. 


specifies the number of bytes required for the 
user's data, 


specifies that data (packed decimal mode) is to 
be converted to unpacked decimal mode. 


specifies that data is to be printed or punched in 
2~character-per-byte hexadecimal representation 


(for example C3, 40, F4,F64). 


specifies the address of the track for which an 
alternate is requested, where cecc is the cylinder 
number and hhhh is the head number. 


specifies a user~franslate table to be used by 
IEBTCRIN. 


specifies that no translation and no special pro- 
cessing is to be performed, 


specifies that the MTST code is to be translated 
to standard EBCDIC, alphabetic characters are 
translated as lowercase, 


specifies that the MTST code is to be translated to 
standard EBCDIC; alphabetic characters are trans- 
lated to uppercase. 


specifies the protection code of the password and, 
if a control password is being assigned to a direct 
access, online data set, specifies the protection 
status of the data set. 


specifies that the output data set is to contain a 
JOB statement and all job steps belonging to the 
job except those steps specified in the STEPNAME 
parameter, 


specifies that the output data set is to contain a 
JOB statement and all job steps specified in the 
STEPNAME parameter. 


specifies that the input was created on a 
Magnetic Data Inscriber, 


specifies that the input data was created on a 
Magnetic Tape Selectric Typewriter. 


specifies that the output is to consist of a JOB 
statement, the job step specified in the STEPNAME 
parameter, and all steps that follow it. 


specifies that the input data sets are partitioned 
data sets. 


specifies that the input data sets are sequential 
data sets. 


specifies that the catalog entry pertaining to the 
data set is to be removed. 


specifies the old master data set is to be updated 
within the space it actually occupies. The old 
master data set must reside on a direct access 
device. UPDATE is valid only when coded 

with CHANGE. 
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VERCHK= NOCHK specifies that no record verification check is 
to be made, 


VOKCHK specifies that a record verification check is to 
be made. 


device= specifies the volume or volumes that contain the 
list data set to be processed. 


device= specifies the device type and volume serial number 
serial of the volume to be processed. 


SCRATCH specifies that no volume serial number check is to 
be made, 





serial 
serial[,serial]... specifies the volume serial number of the volume to 
be processed. 


VOLPASS= specifies that the volume is not security protected, 
If VOLPASS is omitted, 0 is assumed. 


specifies that the volume is security protected. 


VOLUME= device= specifies the device type and volume serial number 
serial of the source volume. 


specifies that all data sets on the specified volume, 
except those protected by a password or those whose 
expiration dates have not yet expired, are to be 
scratched, 


specifies a one- to five-byte decimal relative 
track address representing a primary track on 
which the volume table of contents is to begin. 
The VTOC cannot occupy track 0. 
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Use Reader's Comment Form 
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216071 WYS SA/SO 





spoylay ssao0y 
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OS/VS2 Library Charts (con’t) 











ZS90-8ZAS 
Al awnjo, 21607 
408899014 puewWwoD OSL ZSA/SO 


8S8-CfAS 
LIG3Z - 1p BUINOA 31607 
108$3901g PUEWLUOD OS1 ZSA/SO 





v000-SEAS 


ASSL - 111 awN|OA 21607 
40888901g pueWWOD OSL ZSA/SO 


LS90-8ZAS 


LNNODSV - | BWANA 3:607 
10S$9901q PUBLUWOD OSL ZSA/SO 


$10883890sg PUeEWWOD 


pL8E-9ZAS 
21607 49p€07, SA/SO 


S000-SEAS 
a16o7 Sanam SA/SO 


sapeo7 pue 
saan 40Ipy abexury 





fe2L-LTAS 
1/1d pue “10809 ‘AI 


NVHLHO4 19} (dS5) a6e43eq 
aulynosqns a1ydes9 SA/SO 


dS wYOd9 





GL8E-9ZAS 
31607 s011py aBeyury SA/SO 





Lo22-LZAS 


21607 saulnoy payuauC 
wafqosg s91yde1 SA/SO 





Jajquassy 


Ob2Z-LZAS 


21607 poylay 
ssaooy so1udeid SA/SO 


Wwv9 


LvO8-E£AS 
21607 s3a;\Quiassy SA/SO 








0S90-8ZAS 

21507] saunnoy ad1Asas 
pue wes6olg 10}U0:W 
leuiud4a1 OSL ZSA/SO 


SOUNNOY 891AJ9S 2 GAL 


6€90-8ZAS 
21607 Buipsosay 10133 
93H9O0T ISAS SA/SO 


Buipsoday 40113 
DAHOOT ISAS 


OO0E-O£AD 


(swaisAg SOG pue SO) 
jenuew 21607 wesbosg 

AINA, uONndiudsag wi0y 

Pue SUdNONsysu] O1DeW UO!) 
-di9seq wo jeuiway pasa 
-}Ng ajqewwesbo1g SE/E WAI 


gece 












6¥90-8ZAS 


21607 wesboig 
19.4U0D OSL ZSA/SO 





wesBoig |013U05 


L€90-8ZAS 
21607 
d3110 SA/SO 


d3110 


21607 WYDL SA/SO 





€vS0-8ZAS fS2L-LZAS 

21607) 0d 
-dng juawabeuey, 
A1aa02344 SA/SO 


w6o7 spiy 
a21asag ZSASO 





SPly ad1asag SWH 


6€0Z-O£AS 9b2L-LZAS 


21607 WYL8 SA/SO 





WwVvOL WVv1L8 
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Index 


For macros, iustructions, and control statements,refer to these: BTAM, 
CRJE, data management, JCL, linkage editor, loader, OS/VS system 
assembler, supervisor, utilities, instructions-System/370, and TCAM. 


A 
addition,hexadecimal table 1-57 
alignment, CNOP 1-9 
ANSI tape 
header label 4-24, 4-25 
label processing by components 4-22 
trailer label 4-24, 4-25 
user label 4-26 
volume label 4-23 
volume organization 4-20, 4-21 
assembler 
attributes 1-53 
instructions, system (see OS/VS system assembler) 
macro facilities, summary 1-51 
statement explanations 
assembler language statement 1-48 
macro-instruction statement 1-48 
model statement 1-48 
prototype statement 1-48 
variable symbols 1-54, 1-55 
assembly expressions 1-52 
attributes, assembler statements 1-53 


bibliography 9-1 
binary conversion table 1-56 
BTAM 
line configurations 
start-stop 7-11 
binary synchronous 7-12 
macro parameter notation 7-5 
macros 
AS 7-2 
ASCTR 7-2 
ASLIST 7-2 
ASMTRTAB 7-2 
CHGNTRY 7-2 
CLOSE 7-2 
CONFIGUR 7-2 
CTRGROUP 7-2 
CTRLIST 7-2 
CTRSCHED 7-2 
DATAMGT 7-2 
DCB 7-2 
DEULIST 7-3 
DFTRMLST 7-3 
IODEVICE 7-3 
LERB 7-3 
LERPRT 7-3 
LOPEN 7-3 
ONLIST 7-3 
OPEN 7-2, 7-3 
READ 7-3 
RELBUF 7-3 


Index 1 


macros, continued 
REQBUF 7-3 
RESETPL 7-3 
STEND 7-3 
TGROUP 7-3 
TPEDIT 7-4 
TRLIST 7-4 
TRNSLATE 7-4 
TRSLRCTW 7-4 
TRSLRCT3 7-4 
TRSLSCTW 7-4 
TRSLSCT3 7-4 
TWAIT 7-4 
WAIT 7-4 
WRITE 7-3 

bytes-per-block table 4-13 








CAW (channel address word) 1-11 
capacities, DASD 4-13 
CCW (channel command word) 1-11 
channel address word (CAW) 1-11 
channel command word (CCW) 1-11 
channel status word (CSW) 1-11 
CNOP alignment 1-9 
code translation table 1-2 to 1-6 
codes 
completion 2-12 to 2-29 
condition 1-8 
EBCDIC 1-63, 1-64 
program interruption 1-9 
completion codes for VS1 2-12 to 2-20 
completion codes for VS2 2-21 to 2-29 
component tape label processing 4-16 to 4-26 
condition codes 1-8 
conditional assembly expressions 1-52 
constant values, system assembler 1-49 
control registers 1-7 
control statements (see linkage editor or loader) 
conventions 
for SVC routines 3-15 
linkage register 2-3 
CRJE 
data management commands 
DELETE 5-26 
EDIT 5-26 
EDIT subcommands 5-26 
EDIT subcommands 
linenum 5-25 
CANCEL 5-25 
CHANGE 5-25 
DELETE 5-25 
END 5-25 
INPUT 5-25 
LIST 5-25 
MERGE 5-25 
RENUMBER 5-25 
SAVE 5-25 
SCAN 5-25 


SEND 5-25 ws 
SUBMIT 5-25 
TABSET 5-25 
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EXEC command 5-27 
installation variables 5-27, 5-28 
job processing commands 
SUBMIT 5-26 
OUTPUT 5-26 
CONTINUE 5-26 
CANCEL 5-26 
macros 
CRJELINE 5-23 
CRITABL 5-23 
CRJEUSER 5-23 
message commands 
LISTBC 5-27 
SEND 5-27 
operator commands 
BRDCST 5-29 
CENOUT 5-29 
MODIFY 5-29 
MSG 5-29 
SHOW 5-29 
START 5-29 
STOP 5-29 
USERID 5-29 
session management commands 
LOGON 5-26 
LOGOFF 5-26 
status information commands 
LISTLIB 5-26 
LISTDS 5-27 
STATUS 5-27 
TABSET command 5-27 
terminal commands 
CANCEL 5-24 
CONTINUE 5-24 
DELETE 5-24 
EDIT 5-24 
EXEC 5-24 
LISTBC 5-24 
LISTDS 5-24 
LISTLIB 5-24 
LOGOFF 5-24 
LOGON 5-24 
OUTPUT 5-24 
SEND 5-24 
STATUS 5-24 
SUBMIT 5-24 
TABSET 5-24 


CSW (channel status word) 1-11 


DASD capacities 4-13 
data management 


macro completion codes used in this book 4-2 
macros 

BLDL 4-2 

BSP 4-2 

BUILD 4-2 

BUILDRCD 4-2, 4-3 

CHECK 4-3 

CHKPT 4-3 

CLOSE 4-4 


Index 3 
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macros, continued 
CNTRL 4-4 
DCB 4-5 
DCBD 4-5 
ESETL 4-5 
FEOV 4-5 
FIND 4-5 
FREEBUF 4-5 
FREEDBUF 4-5 
FREEPOOL 4-5 
GET 4-5 
GETBUF 4-6 
GETPOOL 4-6 
NOTE 4-6 
OPEN 4-6 
POINT 4-7 
PRTOV 4-7 
PUT 4-7 
PUTX 4-7 
READ 4-7, 4-8 
RELEX 4-8 
RELSE 4-8 
SETL 4-8 
SETPRT 4-8, 4-9 
STOW 4-10 
SYNADAF 4-10 
SYNADRLS 4-10 
TRUNC 4-11 
WRITE 4-11, 4-12 
XLATE 4-12 
data set label (IBM), tape 4-18 
decimal-hexadecimal 
conversion 1-2, 1-58 
fraction conversion 1-58 to 1-62 
device sense in UCB 2-4 to 2-11 
devices supported by 
BTAM 7-11, 7-12 
TCAM 7-20 to 7-23 
standard label processing 
ANSI 4-20 
IBM 4-14 











E 





EBCDIC codes 1-2 to 1-6, 1-63, 1-64 
EDIT and EDMK pattern characters 1-9 


F 
fixed storage locations 1-10 
format, save area 2-2 
formats, Linkage Editor Record 6-6 
format, utilities 8-2 
fraction conversion, hexadecimal-decimal 1-58 to 1-62 





G 
general services, supervisor 3-29, 3-30 


H 
header label format (tape) 
ANSI 4-24, 4-25 
IBM 4-18 
hexadecimal 
addition and subtraction table 1-57 
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hexadecimal, continued 
multiplication table 1-57 
to decimal conversion 1-56 


oe IBM standard labels (tape) 
data set label 4-18 
label processing by components 4-16 
user label 4-19 
volume label 4-17 
instruction formats, machine 1-7 
instructions, System/370 
pie add 1-13 
w& add (reg) 1-13 
add decimal 1-13 
add halfword 1-13 
add logical 1-13 
add logical (reg) 1-13 
add normalized (long) 1-14 
add normalized (long, reg) 1-14 
add normalized (short) 1-14 
add normalized (short, reg) 1-14 
add normalized (extended) 1-14 
add unnormalized (long) 1-15 
add unnormalized (long, reg) 1-15 
add unnormalized (short) 1-15 
add unnormalized (short, reg) 1-15 
and 1-15 
and (reg) 1-15 
and (immediate) 1-15 
and (character) 1-15 
branch and link 1-16 
branch and link (reg) 1-16 
branch on condition 1-16 
branch on condition (reg) 1-16 
branch on count 1-16 
branch on count (reg) 1-16 
branch on equal 1-16 
branch on high 1-16 
branch on index high 1-16 
branch on index low or equal 1-17 
branch on low 1-17 
branch if mixed 1-17 
branch on minus 1-17 
branch on not equal 1-17 
branch on not high 1-17 
branch on not low 1-17 
branch on not minus 1-17 
branch on not ones 1-17 
branch on not plus 1-17 
branch on not zeros 1-17 
branch if ones 1-17 
branch on overflow 1-17 
branch on plus 1-17 
branch on zero 1-17 
branch if zeros 1-17 
branch unconditional 1-17 
ie branch unconditional (reg) 1-17 
w compare 1-17 
compare (reg) 1-17 
compare (long) 1-19 
compare (long, reg) 1-19 








Index 5 


instructions, System/370, continued 
compare (short) 1-19 
compare (short, reg) 1-19 
compare decimal 1-18 
compare halfword 1-18 
compare logical 1-18 
compare logical (characters) 1-18 
compare logical (immediate) 1-18 
compare logical (reg) 1-18 
compare characters under mask 1-18 
compare logical long 1-19 
convert to binary 1-19 
convert to decimal 1-19 
diagnose 1-19 
divide 1-20 
divide (long) 1-20 
divide (long, reg) 1-20 
divide (reg) 1-20 
divide (short) 1-21 
divide (short, reg) 1-21 
divide decimal 1-20 
edit 1-21 
edit and mark 1-21 
exclusive or 1-21 
exclusive or (character) 1-22 
exclusive or (immediate) 1-22 
exclusive or (reg) 1-22 
execute 1-22 
halt device 1-22 
halt I/O 1-22 
halve (long) 1-22 
halve (short) 1-22 
insert character 1-22 
insert characters under mask 1-22 
insert storage key 1-23 
load 1-23 
load (reg) 1-23 
load (long) 1-24 
load (long, reg) 1-24 
load (short) 1-26 
load (short, reg) 1-26 
load address 1-23 
load and test 1-23 
load and test (long) 1-23 
load and test (short) 1-23 
load complement 1-24 
load complement (long) 1-24 
load complement (short) 1-24 
load control 1-24 
load halfword 1-24 
load multiple 1-25 
load negative 1-25 
load negative (long) 1-25 
load negative (short) 1-25 
load positive 1-25 
load positive (long) 1-25 
load positive (short) 1-25 
load PSW_ 1-26 
load real address 1-26 
load rounded (extended to long) 1-26 
load rounded (long to short) 1-26 
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instructions, System/370, continued 
monitor call 1-27 
move (character) 1-27 
move (immediate) 1-27 
move long 1-27 
move numerics 1-28 
move with offset 1-28 
move zones 1-28 
multiply 1-28 
multiply (extended) 1-29 
multiply (ong) 1-30 
multiply (long, reg) 1-30 
multiply (long/extended) 1-30, 1-31 
multiply (long/extended, reg) 1-31 
multiply (reg) 1-29 
multiply (short) 1-31 
multiply (short, reg) 1-32 
multiply decimal 1-29 
multiply halfword 1-30 
nop (reg) 1-32 





or 1-32 
i or (character) 1-32 
& or (immediate) 1-32 
or (reg) 1-32 
pack 1-32 


purge TLB 1-32 
read direct 1-33 
reset reference bit 1-33 
set clock 1-33 
set clock comparator 1-33 
set CPU timer 1-33 
set program mask 1-34 
set storage key 1-34 
set system mask 1-34 
shift and round decimal 1-34 
shift left double 1-34 
shift left double logical 1-34 
shift left single 1-34 
shift left single logical 1-35 
shift right double 1-35 
shift right double logical 1-35 
shift right single 1-35 
shift right single logical 1-35 
& start I/O 1-35 
start I/O fast release 1-36 
store 1-36 
store (long) 1-37 
store (short) 1-38 
store channel ID 1-36 
store character 1-36 
store characters under mask 1-36 
store clock 1-36 
store clock comparator 1-36 
store control 1-37 
store CPU ID 1-37 
store CPU timer 1-37 
store halfword 1-37 
store multiple 1-37 
store then and system mask 1-38 
store then or system mask 1-38 
subtract 1-38 
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instructions, System/370, continued 

subtract (reg) 1-38 
subtract decimal 1-39 
subtract halfword 1-39 
subtract logical 1-39 
subtract logical (reg) 1-39 
subtract normalized (extended) 1-39, 1-40 
subtract normalized (long) 1-40 
subtract normalized (long, reg) 1-40 
subtract normalized (short) 1-40 
subtract normalized (short, reg) 1-41 
subtract unnormalized (long) 1-41 
subtract unnormalized (long, reg) 1-41 
subtract unnormalized (short) 1-41 
subtract unnormalized (short, reg) 1-41 
supervisor call 1-42 
test and set 1-42 
test channel 1-42 
test I/O 1-42 
test under mask 1-43 
translate 1-43 
translate and set 1-43 
unpack 1-44 
write direct 1-44 
zero and add 1-44 

interruption codes, program 1-10 

interruption control, supervisor 3-28 


J 
Job Control Language (JCL) 
see OS/VS ICL 
see linkage editor JCL 
see loader JCL 











L 
limited channel logout 1-12 
linkage editor 
control statements 
ALIAS 6-6 
CHANGE 6-6 
ENTRY 6-6 
IDENTIFY 6-6 
INCLUDE 6-6 
INSERT 6-6 
LIBRARY 6-6 
NAME 6-6 
ORDER 6-6 
OVERLAY 6-6 
PAGE 6-6 
REPLACE 6-6 
SETSSI 6-6 
return codes 6-5 
incompatible job step options 6-5 
JCL 6-2 
PARM default values 6-4 
PARM= options 6-3 
record formats 6-6 
REGION parameter 6-4 
SIZE values 6-7 
linkage register conventions 2-3 
line configurations, BTAM 
start-stop 7-11 
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line configurations, BTAM, continued 
binary synchronous 7-12 
load module control, supervisor 3-26 
loader 
DD parameter restrictions 6-9 
invoking via macros 6-10 
JCL statements 6-7 
macro parameters 
EP 6-10 
PARAM 6-10 
option list 6-10 
ddname list 6-10 
VL 6-10 
PARM= options 
CALL 6-8 
EP 6-8 
LET 6-8 
MAP 6-8 
NOCALL 6-8 
NOLET 6-8 
NOMAP 6-8 
NOPRINT 6-8 
NORES 6-8 
NOTERM 6-9 
PRINT 6-8 
RES 6-8 
SIZE 6-8 
TERM 6-9 
return codes 6-11 
valid names 6-7 
virtual storage requirements 6-12 


M 
machine instruction formats 1-7 
macro 
completion codes, data management 4-2 
facilities summary, OS/VS assembler 1-51 
macros 
BTAM (see BTAM macros) 
CRJE (see CRJE macros) 
data management (see data management macros) 
SMF 5-2 
supervisor (see supervisor macros) 
TCAM (see TCAM macros) 
multiplication table, hexadecimal 1-57 


N 
number/mnemonic/symbol/code equivalents 1-2 to 1-6 


O 
operator commands 
definition of substitutional operands 5-15 
definition of substitutional operands, RES (see RES) 
VSI (see VSI operator commands) 
VS2 (see VS2 operator commands) 
OS/VS JCL (Job Control Language) 
statements 
COMMENT 5-8 
DELIMITER 5-8 
DD 5-5 
EXEC 5-4 
JOB 5-3 
NULL 5-8 


Index 9 


statements, continued 
PEND 5-8 
PROC 5-8 

OS/VS system assembler 

constant values 1-49 
instructions 

ACTR 1-45 
AGO 1-45 
AIF 1-45 
ANOP 1-45 
CCW 1-45 
CNOP 1-45 
COM _ 1-45 
COPY 1-45 
CSECT 1-45 
CXD 1-45 
DC 1-45 
DROP 1-45 
DS 1-45 
DSECT 1-45 
DXD 1-45 
EJECT 1-45 
END 1-45 
ENTRY 1-45 
EQU 1-45 
EXTRN 1-45 
GBLA 1-45 
GBLB 1-45 
GBLC 1-46 
ICTL 1-46 
ISEQ 1-46 
LCLA 1-46 
LCLB 1-46 
LCLC 1-46 
LTORG 1-46 
MACRO 1-46 
MEND 1-46 
MEXIT 1-46 
MNOTE 1-46 
OPSYN 1-46 
ORG 1-46 
POP 1-46 
PRINT 1-46 
PUNCH 1-46 
PUSH 1-46 
REPRO 1-46 
SETA 1-46 
SETB 1-46 
SETC 1-47 
SPACE 1-47 
START 1-47 
TITLE 1-47 
USING 1-47 
WXTRN 1-47 

















P 
parameter notation 
BTAM macros 7-5 to 7-8 
supervisor macros 3-9 to 3-14 
powers of 16 1-56 
processing 
ANSI standard tape labels 4-22 
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processing, continued 


IBM standard tape labels 4-16 
programming conventions for SVC routines 3-15 
program interrupt codes 1-9 
program status word (PSW) 1-11 
PSW (program status word) 1-11 


R 
register, linkage conventions 2-3 
registers, control 1-7 
RES 
definition of substitutional operands 5-22 
operator commands 
central 
CANCEL 5-18 
DISPLAY 5-18 
HOLD 5-18 
LISTBC 5-18 
LOGON 5-18 
LOGOFF 5-18 
MODIFY 5-18 
MONITOR 5-18 
RELEASE 5-18 
REPLY 5-18 
RESET 5-18 
ROUTE 5-18 
SEND 5-19. 
START 5-19 
STOP 5-19 
STOPMN 5-19 
WRITER 5-19 
workstation 
CANCEL 5-20 
DISPLAY 5-20 
HOLD 5-20 
LISTBL 5-20 
LOG 5-20 
LOGOFF 5-20 
LOGON 5-20 
MODIFY 5-20 
MONITOR 5-20 
RELEASE 5-20 
REPLY 5-20 
RESET 5-20 
ROUTE 5-20 
SEND 5-20 
STOP 5-21 
STOPMN 5-21 
WRITER 5-21 
return codes 
see linkage editor or loader 
see utilities 


save area format 2-2 
sense information, UCB 2-4 to 2-11 
SMFDEFLT macro outline 5-16 
storage locations, fixed 1-10 
subtraction, hexadecimal table 1-57 
supervisor 
macro parameter notation 3-9 
macros 


f 


macros, continued 
ABEND 3-2 
ATTACH 3-2 
CALL 3-3 
CHAP 3-3 
DELETE 3-3 
DEQ 3-3 
DETACH 3-3 
DOM 3-3 
DXR 3-3 
ENQ 3-3, 3-4 
EXTRACT 3-4 
FREEMAIN 3-4 
GETMAIN 3-5 
GTRACE 3-5 
IDENTIFY 3-5 
LINK 3-5, 3-6 
LOAD 3-6 
PGRLSE 3-6 
POST 3-6 
RETURN 3-6 
SAVE 3-6 
SEGWT 3-6 
SNAP 3-6 
SPIE 3-6, 3-7 
STAE 3-7 
STATUS 3-7 
STIMER 3-7 
TIME 3-7 
TTIMER 3-7 
WAIT 3-7 
WAITR 3-7 
WTL 3-7, 3-8 
WTO 3-8 
WTOR 3-8 
XCTL 3-8 
task control 3-31 
termination 3-30 
general services 3-29, 3-30 
load module control 3-26 
program interruption control 3-28 
synchronization 3-27 
virtual storage allocation 3-32 
SVC 
conventions 3-15 
summary for VS1 3-16 to 3-20 
summary for VS2 3-21 to 3-25 
synchronization, supervisor 3-27 
system assembler constant values 1-49 
system assembler instructions (see OS/VS system assembler) 
System/370 instructions (see instructions) 

















table 
code translation 1-9 
task control, supervisor 3-31 
tape label formats 
header 
ANSI 4-24, 4-25 
IBM 4-18 
trailer 
ANSI 4-24, 4-25 
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trailer, continued 

IBM 4-18 

user 
ANSI 4-26 
IBM 4-19 

volume 
ANSI 4-23 
IBM 4-17 

TCAM 

device support 7-21 

macros 
CANCELMG 7-13 
CHECK 7-13 
CHECKPT 7-13 
CKREQ 7-13 
CLOSE 7-13 
CODE 7-13 
COUNTER 7-13 
CUTOFF 7-13 
DATETIME 7-13 
ERRORMSG 7-13 
FORWORD 7-13 
GET 7-13 
HOLD 7-13 
ICHNG 7-13 
ICOPY 7-13 
INBLOCK 7-13 
INBUF 7-13 
INEND 7-13 
INHDR 7-13 
INITIATE 7-14 
INMSG 7-14 
INTRO 7-14 
INVLST 7-14 
LOCK 7-14 
LOCOPT 7-14 
LOG 7-14 
LOGTYPE 7-14 
MCPCLOSE 7-14 
MCOUNT 7-14 
MRELEASE 7-14 
MSGEDIT 7-14 
MSGFORM 7-14 
MSGGEN 7-14 
MSGLIMIT 7-14 
MSGTYPE 7-15 
OPEN 7-15 
OPTION 7-15 
ORIGIN 7-15 
OUTBUF 7-15 
OUTEND 7-15 
OUTHDR 7-15 
OUTMSG 7-15 
PATH 7-15 
PCB 7-15 
POINT 7-15 
PRIORITY 7-15 
PUT 7-15 
QCOPY 7-15 
QSTART 7-15 
READ 7-15 
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a 


macros, continued 
READY 7-15 
REDIRECT 7-15 
RETRY 7-15 
SCREEN 7-16 
SEQUENCE 7-16 
SETEOF 7-16 
SETEOM 7-16 
SETSCAN 7-16 
STARTMH 7-16 
TCHNG 7-16 
TCOPY 7-16 
TERMINAL 7-16, 7-17 
TERRSET 7-17 
TLIST 7-17 
TPDATE 7-17 
TPEDIT 7-17 
TPROCESS 7-17 
TTABLE 7-17 
UNLOCK 7-17 
WRITE 7-17 
operator commands 
DISPLAY 7-19 
HALT 7-19 
HOLD 7-19 
MODIFY 7-19 
RELEASE 7-20 
VARY 7-20 
trailer label format, tape 
ANSI 4-24, 4-25 
IBM 4-18 
translation table, code 1-2 to 1-6 
TSO 
macros 7-25 
modified TCAM macros 7-24 
operator commands 7-25 
unused TCAM macros 7-24 











U 

UCB sense information 2-4 to 2-11 

user label format, tape 
ANSI 4-26 
IBM 4-19 

Utilities 
data set 8-2 
Definition of Operands 8-41 
format 8-2 
independent 8-2 
system 8-2 

Utility Programs 
IBCDASDI 8-5 
IBCDMPRS 8-7 
ICAPRTBL 8-8 
IEBCOMPR 8-9 
IEBCOPY 8-10 
IEBDG 8-12 
{EBEDIT 8-15 
TIEBGENER 8-16 
IEBISAM 8-18 
IEBPTPCH 8-19 
IEBTCRIN 8-21 
IEBUPDTE 8-26 
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Utility Programs, continued 
IEHATLAS 8-28 
IEHDASDR 8-29 
IEHINITT 8-32 
IEHIOSUP 8-33 
IEHLIST 8-34 
IEHMOVE 8-35 
IEHPROGM 8-38 
IFHSTATR 8-40 


variable symbols, OS/VS system assembler 1-54, 1-55 
virtual storage allocation, supervisor 3-32 
virtual storage requirements for the loader 6-12 
volume 
label (tape) 
ANSI 4-23 
IBM 4-17 
organization 
ANSI standard labels 4-20, 4-21 
IBM standard labels 4-14, 4-15 
VS1 operator commands 
CANCEL 5-9 
DEFINE 5-9 
DISPLAY 5-9 
DUMP 5-9 
HALT 5-9 
HOLD 5-9 
LOG 5-9 
MODE 5-9 
MODIFY 5-9 
MONITOR 5-9 
MOUNT 5-9 
MSGRT 5-10 
RELEASE 5-10 
REPLY 5-10 
RESET 5-10 
SET 5-10 
START 5-10 
STOP 5-10 
STOPMN 5-10 
SWAP 5-10 
SWITCH. 5-10 
UNLOAD 5-10 
VARY 5-10, 5-11 
WRITELOG 5-11 
WRITER 5-11 
VS2 operator commands 
CANCEL 5-12 
CONTROL 5-12 
DISPLAY 5-12 
DUMP 5-12 
HALT 5-12 
HOLD 5-12 
LOG 5-12 
MODE 5-12 
MODIFY 5-12 
MONITOR 5-12 
MOUNT 5-13 
MSGRT 5-13 
RELEASE 5-13 
REPLY 5-13 
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VS2 operator commands, continued 
RESET 5-13 
SET 5-13 
START 5-13 
STOP 5-13 
STOPMN 5-13 
SWAP 5-13 
SWITCH 5-13 
UNLOAD 5-13 
VARY 5-13, 5-14 
WRITELOG 5-14 
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Your views about this publication may help improve its usefulness, this form 


READER’S COMMENT FORM 


will be sent to the author’s department for appropriate action. Using this 
form to request system assistance or additional publications will delay 


response, however. For more direct handling of such request, please contact 


your IBM representative or the IBM Branch Office serving your locality. 

Your comments will be carefully reviewed by the persons responsible for 

Q@ritire and publishing this material. All comments and suggestions become 
the property of IBM. 


e Does the publication meet your needs? 


e Did you find the material: 
Organized for convenient use? 
Complete? 


@ What is your occupation?- 


® How do you use this publication: 
As an instructor in a class? 
As a student in a class? 
As a reference manual? 


Your comments: 


Yes No 
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Cj tod 
E= CC 
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= 


If you would like a reply, please supply your name and address. 


Thank you for your cooperation. No postage stamp necessary if mailed in 
the U.S.A. (Elsewhere, an IBM office or representative will be happy to 


forward your comments.) 
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